在工作表中使用粘贴选项复制区域 – Aspose.Cells Cloud API

此 REST API 用于复制 Excel 工作簿中工作表内的区域。有关相关操作，请参阅 获取区域 和 更新区域 文档。

前置条件：要使用此端点，您必须拥有有效的 OAuth 2.0 / JWT 令牌，并确保 API 版本与请求 URL 匹配。

REST API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges

请求参数

参数名称	类型	位置	描述
name	string	path	工作簿的名称。
sheetName	string	path	工作表的名称。
rangeOperate	string	body	要执行的操作：`copydata`（复制数据）、`copystyle`（复制样式）、`copyto`（复制数据和样式）或 `copyvalue`（仅复制值）
folder	string	query	包含工作簿的文件夹。
storageName	string	query	存储服务的名称。

说明：rangeOperate 字段决定复制的内容。使用 copydata 仅复制单元格值；使用 copystyle 仅复制格式；使用 copyto 同时复制数据和样式；使用 copyvalue 复制值但不复制公式。API 支持最多 100 万单元格的区域；更大的区域可能导致超时。

OpenAPI 规范定义了一个公开可用的编程接口，可让您直接从 Web 浏览器发起 REST 交互。

您可以使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何使用 cURL 调用 Cloud API。

请求

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/ranges" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "Operate": "string",
        "Source": {
          "ColumnCount": 0,
          "ColumnWidth": 0,
          "FirstColumn": 0,
          "FirstRow": 0,
          "Name": "string",
          "RefersTo": "string",
          "RowCount": 0,
          "RowHeight": 0,
          "Worksheet": "string"
        },
        "Target": {
          "ColumnCount": 0,
          "ColumnWidth": 0,
          "FirstColumn": 0,
          "FirstRow": 0,
          "Name": "string",
          "RefersTo": "string",
          "RowCount": 0,
          "RowHeight": 0,
          "Worksheet": "string"
        },
        "PasteOptions": {
          "OnlyVisibleCells": true,
          "PasteType": "string",
          "SkipBlanks": true,
          "Transpose": true
        }
      }'

响应

{
  "Code": 200,
  "Status": "OK"
}

成功响应将返回 200 OK 状态。若发生错误，API 可能返回如下有效载荷：

{
  "Code": 400,
  "Message": "Bad Request – 参数无效。"
}

或

{
  "Code": 401,
  "Message": "Unauthorized – 缺少或无效的身份验证令牌。"
}

这些错误对象包含 HTTP 状态码和描述性消息，有助于诊断问题。

您可在此处下载示例工作簿以测试复制操作：sample.xlsx。

云 SDK 家族

使用 SDK 是加速开发的最佳方式。SDK 处理底层细节，使您能专注于项目任务。请查阅 GitHub 仓库，了解 Aspose.Cells Cloud SDK 的完整列表。

以下代码示例展示了如何使用各种 SDK 调用 Aspose.Cells Web 服务：