查找数据

命令说明

在数据表指定的区域中查找数据，返回可查找到的单元格索引

命令原型

arrayRet = Datatable.SearchValue(dtTable, scope, value, bCaseSensitive, bAllReturn)

命令参数

参数	必选	类型	默认值	说明
dtTable	True	expression	objDatatable	被读取的数据表对象，通常为“构建数据表”命令或“从Excel表格构建数据表”命令的返回值
scope	True	expression	[]	指定的区域，支持二维行列数组格式，如[[单元格1行号，单元格1列号],[单元格2行号，单元格2列号]]的形式。当仅传入一个单元格索引（[单元格1行号，单元格1列号]）时，则从指定单元格的行号和列号开始往下到最后有数据的单元格所组成的矩形区域中进行查找；若传入空数组（默认值），则查找整个数据表区域
value	True	string	""	需要查找的数据内容。当查找不到指定的数据内容时，返回空数组
bCaseSensitive	True	boolean	True	是否区分查找数据的大小写。默认为“是”，查找时严格区分查找数据的大小写；若选择“否”，查找时忽略查找数据的大小写（模糊查询）
bAllReturn	True	boolean	True	是否返回全部单元格，选择“是”则返回包含所有查找到数据的单元格索引（二维数组），选择“否”则返回查找区域内第一个查找到数据的单元格索引（一维数组）

返回结果

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

运行实例

/*********************************查找数据****************************************
命令原型：
    arrayRet = Datatable.SearchValue(dtTable, scope, value, bCaseSensitive, bAllReturn)
入参：
    dtTable--数据表对象。注：被读取的数据表对象，通常为“构建数据表”命令或“从Excel表格构建数据表”命令的返回值
    scope--区域。注：指定的区域，支持二维行列数组格式，如[[单元格1行号，单元格1列号],[单元格2行号，单元格2列号]]的形式。当仅传入一个单元格索引（[单元格1行号，单元格1列号]）时，则从指定单元格的行号和列号开始往下到最后有数据的单元格所组成的矩形区域中进行查找；若传入空数组（默认值），则查找整个数据表区域
    value--查找数据。注：需要查找的数据内容。当查找不到指定的数据内容时，返回空数组
    bCaseSensitive--区分大小写。注：是否区分查找数据的大小写。默认为“是”，查找时严格区分查找数据的大小写；若选择“否”，查找时忽略查找数据的大小写（模糊查询）
    bAllReturn--全部返回。注：是否返回全部单元格，选择“是”则返回包含所有查找到数据的单元格索引（二维数组），选择“否”则返回查找区域内第一个查找到数据的单元格索引（一维数组）
出参：
    arrayRet--函数调用的输出保存到的变量。
注意事项：
    无
********************************************************************************/
Dim arrayRet = ""
arrayRet = Datatable.SearchValue(objDatatable, [], "", True, True)
TracePrint(arrayRet)