DTSheet 对象(一)

上一篇 / 下一篇  2007-05-15 14:00:36 / 个人分类:QTP学习

DTSheet指的是run-time Data Table中的一个表。

注意:

DTSheet Object的所有方法只适用于run-time DataTable对象。对于run-time DataTable的任何改变都会反映在测试结果中,并不对Design Time DataTable产生影响。

1.     方法(methods

Ø        添加列对象(AddParameter Method

描述

run-time data tablesheet中添加指定的列名(或参数),

为该列的第1行设置指定的数据,

并返回这个列(或参数)对象以便于用户在同一个语句中直接设置或获取它的属性properties值。

语法

DTSheet.AddParameter(ParameterName,Value)

Argument

Type

Descrīption

ParamterName

String

指定新列名。如果Sheet中已经存在同名的列名,则新的列名称显示为“列名1”,如果列名包括非法字符,非法字符会自动被替换为“_”。

Value

String

指定新列的第1行数据。

Return Value

DTParameter对象

返回一个DTParameter对象。

示例

下面的例子使用AddParameter方法在一个新的sheetMysheet”中创建一个新的列“Arrival”,并设置该列的第一个单元格的值为“New York”。

因为这个方法会返回这个新的列(参数)对象,因此在同一个语句中,也可以使用Sheet的方法,也可以检查该列的properties值。

ParamName=DataTable.AddSheet("MySheet").AddParameter("Arrival", "New York").Name

本语句新增了一个SheetMysheet”,并为该Sheet新增了一个列参数“Arrival”,同时为该列的第1行赋了一个值“New York”。因为AddParameter返回了一个列DTparameter对象,因此通过本语句后面的“.Name”获取DTParametername属性值,“ParamName=”就表示返回的DTParametername属性值将保存在变量ParamName中。

注意:如果列参数“Arrival”已经在表Sheet中存在,则上面的例子的返回值是“Arrival1”。

 

Ø        获取列对象(GetParameter Method

描述

run-time Data Table sheet获取指定列对象。以便于对该对象进行操作。

语法

DTSheet.GetParameter(ParameterID)

Argument

Type

Descrīption

ParameterID

String/Index

指定要获取的列名或indexIndex1开始。

返回值

DTParameter对象.

返回一个DTParameter对象。

示例

下面的例子使用GetParameter方法,从运行时表Mysheet中获取“Destination”列对象。

DataTable.GetSheet("MySheet").GetParameter("Destination")

 

Ø        获得Sheet的总列数(GetParameterCount Method

描述

返回运行时DataTable Sheet的总列数。

语法

DTSheet.GetParameterCount

返回值

数值

示例

下面的例子使用GetParameter方法取得运行时Data Table SheetMysheet”的总列数,并将它写入Report

paramcount = DataTable.GetSheet("MySheet").GetParameterCount

Reporter.ReportEvent 2, "There are " &paramcount, "columns in the data sheet."

 

Ø        删除列(DeleteParameter Method

描述

从运行时Data TableSheet中删除指定的列。

语法

DTSheet.DeleteParameter(ParameterID)

Argument

Type

Descrīption

ParameterID

Variant

指定要删除的列的名称或列indexIndex1开始。

示例

下面的例子使用DeleteParameter方法,删除运行时Data TableSheetMysheet”表中的“Arrival”列。

DataTable.GetSheet("MySheet").DeleteParameter("Arrival")

注意:如果在测试脚本中要使用到某个列,删除该列可能引起测试失败。

 

Ø        获取当前行号(GetCurrentRow Method

描述

获取运行时Data TableSheet的当前活动行的行号。

语法

DTSheet.GetCurrentRow

返回值

数值

示例

下面的例子使用GetCurrentRow方法,来获取运行时Data Table的表“Mysheet”的当前活动行行号,并将它写入报告。

row = DataTable.GetSheet("MySheet").GetCurrentRow

Reporter.ReportEvent 1, "Row Number", row

上面的语句通过GetSheet返回表对象“Mysheet”,以便于后面使用GetCureentRow方法。


TAG: QTP学习

 

评分:0

我来说两句

Open Toolbar