# getColumnByHeader-按表头获取列
调用getColumnByHeader函数按照列名（表头）获取列对象。
最小支持版本：5.0.0
# 接口说明
已打开的工作簿对象,详情参见open (opens new window)。
已获取工作表对象,详情参见getSheetByName (opens new window)。
已获取区域对象,详情参见getRange (opens new window)。
# 语法
<ExcelRange object>.getColumnByHeader(<header>)
1
<ExcelRange object>.按表头获取列(<header>)
1
# 函数类型
实例函数
# 请求参数
| 参数名称 | 类型 | 是否必选 | 默认值 | 示例值 | 描述 |
|---|---|---|---|---|---|
| header | Cube.Lang.String | 是 | 无 | "A" | 列名(表头)，当该区域设置了首行为列名时，可以通过首行内单元格的值， 获取到该列对象。当未设置首行为列名时，可以通过列标签("A"，"B"等)获取到列对象。 |
# 返回参数
| 参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Result | Cube.App.Excel.ExcelColumn | Cube.App.Excel.ExcelColumn | 获取到的列对象。 |
# 请求示例
ExcelAction.open("C:\\Users\\TEST\\Desktop\\Example\\test.xlsx", {}).getSheetByName("Sheet1").getRange("A1:D4", false).getColumnByHeader("A")
1
最近更新时间: {
"value": "2023-09-12",
"effect": true
}