数据表的相关操作

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）

描述