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方法。