跳到主要内容

读取区域

命令说明​

读取工作表中指定区域的值,返回二维数组

命令原型​

arrayRet = Excel.ReadRange(objExcelWorkBook,sheet,strRange,bRetDisplay)

命令参数​

参数必选类型默认值说明
objExcelWorkBookTrueexpressionobjExcelWorkBook使用 "打开Excel工作簿"命令（Excel.OpenExcel） 或 "绑定Excel工作簿" 命令（Excel.BindBook）返回的工作簿对象
sheetTruestring"Sheet1"如果使用字符串，则表示指定工作表的名字；使用数字，则表示指定工作表的顺序（从0开始）
strRangeTruestring"A1:B2"指定的区域，支持单元格名如"A1:B2"与二维行列数组如[[单元格1行号，单元格1列号],[单元格2行号，单元格2列号]]两种形式，使用单元格名时不区分大小写。当只写一个单元格时，读取从单元格开始到此表最后有数据的地方
bRetDisplayTruebooleanTrue选择是，则返回内容与Excel单元格中显示的内容一致，且始终以字符串形式返回(当单元格内容有换行时，返回的内容会在首尾自动加上双引号)；选择否，则返回内容会根据数据类型自动转换，如0.1返回数值0.1而不是字符串"0.1"

返回结果​

arrayRet，将命令运行后的结果赋值给此变量。

运行实例​

/*********************************读取区域***************************************
命令原型：
    arrayRet = Excel.ReadRange(objExcelWorkBook,"Sheet1","A1:B2",true)
入参：
    objExcelWorkBook--Excel工作簿对象（使用 "打开Excel"命令（Excel.OpenExcel） 打开的工作簿或使用"绑定Excel"命令（Excel.BindBook）绑定的工作簿对象）。
    sheet--如果使用字符串，则表示指定工作表的名字；使用数字，则表示指定工作表的顺序（从0开始）。
    strRange--指定的区域，支持单元格名如"A1:B2"与二维行列数组如[[单元格1行号，单元格1列号],[单元格2行号，单元格2列号]]两种形式，当使用单元格名时不区分大小写。
    bRetDisplay--选择是，则返回内容与Excel单元格中显示的内容一致，且始终以字符串形式返回(当单元格内容有换行时，返回的内容会在首尾自动加上双引号)；选择否，则返回内容会根据数据类型自动转换，如0.1返回数值0.1而不是字符串"0.1"
出参：
    arrayRet--函数调用的输出保存到的变量。
注意事项：
    该命令不能单独使用，需配合 "打开Excel"命令（Excel.OpenExcel） 或"绑定Excel"命令（Excel.BindBook）一起使用才能正常使用，单独使用则会报错。
**********************************************************************************/
Dim objExcelWorkBook = ""
Dim num = "2"
objExcelWorkBook = Excel.OpenExcel(@res"测试.xlsx",True,"Excel","","")
TracePrint "-----------------变量拼接使用模式------------------"
arrayRet = Excel.ReadRange(objExcelWorkBook,"Sheet1","A1:A"&num,true)
TracePrint "读取区域：Excel对象Sheet1工作表A1-B2区域的值为:"
TracePrint arrayRet
TracePrint "-----------------常规使用模式------------------"
arrayRet = Excel.ReadRange(objExcelWorkBook,"Sheet1","A1:B2",true)
TracePrint "读取区域：Excel对象Sheet1工作表A1-B2区域的值为:"
TracePrint arrayRet
TracePrint "-----------------数组使用模式------------------"
arrayRet = Excel.ReadRange(objExcelWorkBook,"Sheet1",[[1,1],[2,1]],true)
TracePrint "读取区域：Excel对象Sheet1工作表A1-B2区域的值为:"
TracePrint arrayRet
Excel.CloseExcel(objExcelWorkBook,False)

可视化样例​