DTSheet指的是run-time Data Table中的一个表。
注意:
DTSheet Object的所有方法只适用于run-time DataTable对象。对于run-time DataTable的任何改变都会反映在测试结果中,并不对Design Time DataTable产生影响。
1. 方法(methods)
Ø 添加列对象(AddParameter Method)
描述
向run-time data table的sheet中添加指定的列名(或参数),
为该列的第1行设置指定的数据,
并返回这个列(或参数)对象以便于用户在同一个语句中直接设置或获取它的属性properties值。
语法
DTSheet.AddParameter(ParameterName,Value)
Argument | Type | Descrīption |
ParamterName | String | 指定新列名。如果Sheet中已经存在同名的列名,则新的列名称显示为“列名1”,如果列名包括非法字符,非法字符会自动被替换为“_”。 |
Value | String | 指定新列的第1行数据。 |
Return Value
DTParameter对象
返回一个DTParameter对象。
示例
下面的例子使用AddParameter方法在一个新的sheet“Mysheet”中创建一个新的列“Arrival”,并设置该列的第一个单元格的值为“New York”。
因为这个方法会返回这个新的列(参数)对象,因此在同一个语句中,也可以使用Sheet的方法,也可以检查该列的properties值。
ParamName=DataTable.AddSheet("MySheet").AddParameter("Arrival", "New York").Name
本语句新增了一个Sheet“Mysheet”,并为该Sheet新增了一个列参数“Arrival”,同时为该列的第1行赋了一个值“New York”。因为AddParameter返回了一个列DTparameter对象,因此通过本语句后面的“.Name”获取DTParameter的name属性值,“ParamName=”就表示返回的DTParameter的name属性值将保存在变量ParamName中。
注意:如果列参数“Arrival”已经在表Sheet中存在,则上面的例子的返回值是“Arrival1”。
Ø 获取列对象(GetParameter Method)
描述
从run-time Data Table sheet获取指定列对象。以便于对该对象进行操作。
语法
DTSheet.GetParameter(ParameterID)
Argument | Type | Descrīption |
ParameterID | String/Index | 指定要获取的列名或index。Index从1开始。 |
返回值
DTParameter对象.
返回一个DTParameter对象。
示例
下面的例子使用GetParameter方法,从运行时表Mysheet中获取“Destination”列对象。
DataTable.GetSheet("MySheet").GetParameter("Destination")
Ø 获得Sheet的总列数(GetParameterCount Method)
描述
返回运行时DataTable Sheet的总列数。
语法
DTSheet.GetParameterCount
返回值
数值
示例
下面的例子使用GetParameter方法取得运行时Data Table Sheet“Mysheet”的总列数,并将它写入Report。
paramcount = DataTable.GetSheet("MySheet").GetParameterCount
Reporter.ReportEvent 2, "There are " ¶mcount, "columns in the data sheet."
Ø 删除列(DeleteParameter Method)
描述
从运行时Data Table的Sheet中删除指定的列。
语法
DTSheet.DeleteParameter(ParameterID)
Argument | Type | Descrīption |
ParameterID | Variant | 指定要删除的列的名称或列index。Index从1开始。 |
示例
下面的例子使用DeleteParameter方法,删除运行时Data Table的Sheet“Mysheet”表中的“Arrival”列。
DataTable.GetSheet("MySheet").DeleteParameter("Arrival")
注意:如果在测试脚本中要使用到某个列,删除该列可能引起测试失败。
Ø 获取当前行号(GetCurrentRow Method)
描述
获取运行时Data Table的Sheet的当前活动行的行号。
语法
DTSheet.GetCurrentRow
返回值
数值
示例
下面的例子使用GetCurrentRow方法,来获取运行时Data Table的表“Mysheet”的当前活动行行号,并将它写入报告。
row = DataTable.GetSheet("MySheet").GetCurrentRow
Reporter.ReportEvent 1, "Row Number", row
上面的语句通过GetSheet返回表对象“Mysheet”,以便于后面使用GetCureentRow方法。
Ø 获取Sheet的总行数(GetRowCount Method)
描述
返回运行时Data Table Sheet的总行数。(以数据最长的列的行数为准)。
语法
DTSheet.GetRowCount
返回值
数值
示例
下面的例子使用GetRowCount方法,返回运行时Data Table“Mysheet”的列数,并写入报告。
rowcount = DataTable.GetSheet("MySheet").GetRowCount
Reporter.ReportEvent 2, "There are " &rowcount, "rows in the data sheet."
Ø 设置当前行(SetCurrentRow Method)
描述
指定运行时Data Table Sheet中的一行为当前活动行。
注意:指定的行必须至少包括一个数据,不能是空行。
语法
DTSheet.SetCurrentRow(RowNumber)
Argument | Type | Descrīption |
RowNumber | Number | 指定行号。 |
示例
下面的例子使用SetCurrentRow方法将运行时Data Table的“Mysheet”表的第2行指定为当前活动行。
DataTable.GetSheet("MySheet").SetCurrentRow(2)
Ø 指定下一行为当前行(SetNextRow Method)
描述
指定当前活动行的下一行为新的当前活动行。
注意:指定为新的当前活动行的行必须至少包括一个数据,不能是空行。如果当前行已经是最后一行,则认为Sheet的第一行为下一行。
语法
DTSheet.SetNextRow
示例
下面的例子使用SetNextRow方法,指定“Mysheet”表当前活动行的下一行为新的当前行。
DataTable.GetSheet("MySheet").SetNextRow
Ø 指定前一行为当前行(SetPrevRow Method)
描述
指定当前行的前一行为新的当前行。
语法
DTSheet.SetPrevRow
示例
下面的例子使用SetPrevRow方法设置“Mysheet”表的当前行的前一行为新的当前行。
DataTable.GetSheet("MySheet").SetPrevRow
2. Property
Ø Name
描述
返回运行时表(Sheet)的表名。
语法
DTSheet.Name
示例
下面的例子使用Name方法获得运行时Data Table当前活动Sheet的名称,并将名称写入报告。
Sheetname = DataTable.LocalSheet.Name
Reporter.ReportEvent 1, "The Active Sheet is", Sheetname