使用 Excel 条件格式 – API 指南
Contents
[
Hide
]
Excel 中的条件格式可根据单元格的值，以特定颜色高亮显示单元格。
利用条件格式，您可以更直观地探索和分析数据，快速发现关键问题，并识别数据中的模式和趋势。
条件格式可让您轻松高亮显示感兴趣的单元格或单元格区域，突出显示异常值，并通过数据条、色阶和图标集等方式直观呈现数据，这些视觉元素会根据数据中的具体变化而动态调整。
条件格式会根据您指定的条件改变单元格的外观。如果条件为真，则对该单元格区域应用格式；如果条件为假，则该区域保持原样。Excel 提供了多种内置条件，您也可以创建自定义条件（包括使用返回 TRUE 或 FALSE 的公式）。
Aspose.Cells Cloud API 提供了一系列端点，用于以编程方式管理条件格式规则。支持以下操作：
- 获取工作表的条件格式 – 检索应用于工作表的所有条件格式规则。
- 方法：
GET - 端点：
/cells/{fileName}/worksheets/{sheetName}/conditionalFormattings - 参数：
fileName（字符串，必填），sheetName（字符串，必填），可选查询参数如folder、storageName - 示例 cURL：
curl -X GET "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings?folder=Docs&storageName=MyStorage" -H "Authorization: Bearer {access_token}"
- 方法：
- 获取条件格式 – 按其标识符返回特定的条件格式规则。
- 方法：
GET - 端点：
/cells/{fileName}/worksheets/{sheetName}/conditionalFormattings/{index} - 参数：
index（整数，必填），用于标识规则的位置。 - 示例 cURL：
curl -X GET "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings/0" -H "Authorization: Bearer {access_token}"
- 方法：
- 为格式条件添加单元格区域 – 添加将受指定条件格式影响的单元格区域。
- 方法：
POST - 端点：
/cells/{fileName}/worksheets/{sheetName}/conditionalFormattings/{index}/cellarea - 请求体（JSON）：
{ "FirstRow": 1, "FirstColumn": 1, "RowCount": 5, "ColumnCount": 3 } - 示例 cURL：
curl -X POST "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings/0/cellarea" \ -H "Authorization: Bearer {access_token}" \ -H "Content-Type: application/json" \ -d '{"FirstRow":1,"FirstColumn":1,"RowCount":5,"ColumnCount":3}'
- 方法：
- 为格式条件添加条件 – 为现有格式规则定义新条件（例如值或公式）。
- 方法：
POST - 端点：
/cells/{fileName}/worksheets/{sheetName}/conditionalFormattings/{index}/condition - 请求体（JSON）：
{ "Type": "CellValue", "Operator": "GreaterThan", "Formula1": "100" } - 示例 cURL：
curl -X POST "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings/0/condition" \ -H "Authorization: Bearer {access_token}" \ -H "Content-Type: application/json" \ -d '{"Type":"CellValue","Operator":"GreaterThan","Formula1":"100"}'
- 方法：
- 添加格式条件 – 创建完整的条件格式规则，包括类型和样式。
- 方法：
POST - 端点：
/cells/{fileName}/worksheets/{sheetName}/conditionalFormattings - 请求体（JSON）：
{ "Priority": 0, "Type": "HighlightCells", "Style": { "ForegroundColor": "FFFF0000" }, "Condition": { "Operator": "LessThan", "Formula1": "50" }, "CellArea": { "FirstRow": 0, "FirstColumn": 0, "RowCount": 10, "ColumnCount": 5 } } - 示例 cURL：
curl -X POST "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings" \ -H "Authorization: Bearer {access_token}" \ -H "Content-Type: application/json" \ -d @condition.json
- 方法：
- 清除所有条件格式 – 从目标工作表中删除所有条件格式规则。
- 方法：
DELETE - 端点：
/cells/{fileName}/worksheets/{sheetName}/conditionalFormattings - 示例 cURL：
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings" -H "Authorization: Bearer {access_token}"
- 方法：
- 从条件格式中移除单元格区域 – 从条件格式规则中删除先前定义的单元格区域。
- 方法：
DELETE - 端点：
/cells/{fileName}/worksheets/{sheetName}/conditionalFormattings/{index}/cellarea - 示例 cURL：
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings/0/cellarea" -H "Authorization: Bearer {access_token}"
- 方法：
- 删除条件格式 – 从工作表中删除整个条件格式规则。
- 方法：
DELETE - 端点：
/cells/{fileName}/worksheets/{sheetName}/conditionalFormattings/{index} - 示例 cURL：
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/conditionalFormattings/0" -H "Authorization: Bearer {access_token}"
- 方法：
以上示例展示了每项操作所需的 HTTP 方法、URL 模式、关键参数以及示例请求负载。如有需要，您可使用相应语言的 SDK（如 C#、Java、Python 等）获取对应的代码片段。