数据表的相关操作

时间:2021-11-15 12:41:26

DatatableObject指的是run-time Data Table

注意:对本象的所有methods仅适用于run-time DataTable.对run-time DataTable object的改变会反映在测试结果中,不会对design-time Data Table产生任何影响。

1.     方法(methods):

Ø         新增表(AddSheet Method)

描述

向run-time DataTable中增加指定的表,并将它作为返回对象,这样你就可以在同一个语句中直接设置表的属性。

语法

DataTable.AddSheet(SheetName)

参数
    

类型
    

描述

SheetName
    

String
    

新表的表名

返回值

DTSheet对象。

示例

下面的例子用AddSheet方法向Run-time DataTable中创建一个新的表(sheet)“MySheet”,并同时设置新表的一个参数。

Variable=DataTable.AddSheet("MySheet").AddParameter("Time", "8:00")

注:Mysheet表名;AddParameter是DTSheet Object的一个方法,语法“DTSheet.AddParameter(ParameterName,Value)”

 

Ø        删除表(DeleteSheet Method)

描述

从Run-time data table中删除指定的表。

语法

DataTable.DeleteSheetSheetID

参数
    

类型
    

描述

SheetID
    

Variant
    

指定将要被删除的表。表ID可以是表名,也可以是表的index。Index的值从1开始。

示例

下面的例子用DeleteSheet方法从run-time DataTable中删除表“Mysheet”。

DataTable.DeleteSheet"MySheet"

 

Ø        导出Table(Export Method)

描述

将Run-time data tabel导出到本地指定的位置。

语法

DataTable.Export(FileName)

参数
    

类型
    

描述

FileName
    

String
    

导出文件在本地的完整路径。 导出的文件是EXCEL文件。

示例

下面的例子使用Export方法保存Runtime DataTable到C:/flights.xls。

DataTable.Export("C:/flights.xls")

 

Ø        导出表(ExportSheet Method)

描述

将run-time Data Table中的一个sheet导出到指定的文件。

如果指定的文件不存在,则自动创建一个新的文件,并保存表。

如果指定的文件存在,但是文件中没有指定的表名存在,则在该EXCEL文件中插入指定表名的表,新表放在工作薄的最后位置。

如果文件及表都存在,则导出的表覆盖原有的表。

语法

DataTable.ExportSheet(FileName, DTSheet)

参数
    

类型
    

描述

FileName
    

String
    

导出文件的完整路径。

DTSheet
    

Variant
    

将要导出的run-time Data Table中的表的名称或index。Index值从1开始。

示例

下面的例子使用ExportSheet方法导出RuntimeDataTable的第1个表,保存在C:/name.xls中。

DataTable.ExportSheet"C:/name.xls" ,1

 

Ø        导入Table(Import Method)

描述

将Excle文件导入到run-time Data Table中。

注意:

导入的表必须与test或component匹配。即EXCEL文件的表(即sheet)名必须与Action的名称匹配,各表的列名必须与run-time Data Table中的参数(即列名)匹配。

如果导入的EXCEL文件包括combo box或list单元格、公式或其它特殊单元格式,这些格式将不会被导入,在DataTable中都会以固定的值显示。

语法

DataTable.Import(FileName)

参数
    

类型
    

描述

FileName
    

String
    

要被导入的Excle文件的完整路径。

示例

导入的Table将完全覆盖RuntimeDataTable的已有数据(指所有表的所有数据。)

下面的例子使用Import方法,导入Excel文件"C:/flights.xls"。

DataTable.Import("C:/flights.xls")

 

Ø        导入表(ImportSheet Method)

描述

将Excle文件中一个表(sheet)导入到指定的run-time Data Table表中。导入后,Excle表的数据将覆盖run-time Data Table表的数据。

注意:

被导入的Excle表中的列标题必须与DataTableAction的列参数匹配。否则可能导致Test或Component失败。

导入后,Excle表名将自动替换DataTable中的表名。如果Excel与DataTable的表名不一致,可能会引起测试失败。

如果导入的Excle包括组合框或下拉列表、条件格式、或其它特殊单元格式,这些格式不会被导入,这些单元格在DataTable中都以固定的值显示。

语法

DataTable.ImportSheet(FileName,SheetSource,SheetDest)

参数
    

类型
    

描述

FileName
    

String
    

Excle文件的完整路径及文件名。

SheetSource
    

Variant
    

Excel表名或index。Index值从1开始。

SheetDest
    

Variant
    

Data Table表的表名或index。Index值从1开始。

示例

下面的例子使用ImportSheet方法导入Excel文件name.xls的第1个表,DataTable中的目标表是“NAME”。

DataTable.ImportSheet "C:/name.xls" ,1 ,"name"

 

Ø        获取当前行行号(GetCurrentRow Method)

描述

返回run-time Data Table第一个表的当前活动行的行号。(第一个表指的是global表,或Business Components的business component表。

语法

DataTable.GetCurrentRow

返回值

数字

示例

下面的例子使用GetCurrentRow方法获取run-time Data Table的当前活动行行号,并将获取的行号写到Report中。

row = DataTable.GetCurrentRow

Reporter.ReportEvent 1, "Row Number", row

Reproter的ReprotEvent方法的语法:Reporter.ReportEventEventStatus, ReportStepName, Details [, in]

如果使用row = DataTable.GetSheet("MySheet").GetCurrentRow语句,则可以获得指定表“Mysheet”的当前行号。

 

 

 

Ø   

   设置某行为当前活动行(SetCurrentRow Method)

描述

将run-time Data Table中的某行设置为当前活动行。

注意:你所指定的行必须至少包括一个数据,不能是空行。

语法

DataTable.SetCurrentRow(RowNumber)

参数
    

类型
    

描述

RowNumber
    

Number
    

指定成为当行活动行的行号。行号从1开始。

示例

下面的例子使用SetCurrentRow方法,指定run-time Data Table的Global表的第2行成为当前活动行。

DataTable.SetCurrentRow(2)

注:通过与GetSheet方法联合使用,可以设置某个Action表的某行为当前行。如row = DataTable.GetSheet("MySheet").GetCurrentRow。

 

Ø        设置下一行为当前活动行(SetNextRow Method)

描述

将run-time Data Table当前活动行的下一行设置为新的当前活动行。

注意:将设置为当行活动行的行必须至少包括一个数据,不能是空行。如果当前行已经是DataTable的最后一行,本方法将设置DataTable的第1行为新的当行活动行。

语法

DataTable.SetNextRow

示例

下面的例子使用SetNextRow方法将Run-time DataTable的global表的当前活动行的下一行设置为新的活动行。

DataTable.SetNextRow

 

Ø        设置前一行为当前活动行(SetPrevRow Method)

描述

设置run-time Data Table当前活动行的前一行为新的当前行。

注意:如果当前活动行是DataTable的第1行,本方法将认为DataTable的最后一行是当前活动行的前一行。

语法

DataTable.SetPrevRow

示例

下面的例子使用SetPrevRow方法将Run-time data table的global表的当前活动行的前一行置为新的当前活动行。

DataTable.SetPrevRow

 

Ø        获取行数(GetRowCount Method)

描述