跳到主要内容

读取区域

命令说明

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

命令原型

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)

可视化样例