DTSheet 对象

上一篇 / 下一篇  2007-05-22 13:50:08 / 个人分类:QTP

 
  • DTSheet 对象(一)

    2007-05-15 14:00:36

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

    Ø        获取Sheet的总行数(GetRowCount Method

    描述

    返回运行时Data Table Sheet的总行数。(以数据最长的列的行数为准)。

    语法

    DTSheet.GetRowCount

    返回值

    数值

    示例

    下面的例子使用GetRowCount方法,返回运行时Data TableMysheet”的列数,并写入报告。

    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


  • TAG: QTP

     

    评分:0

    我来说两句

    日历

    « 2024-05-03  
       1234
    567891011
    12131415161718
    19202122232425
    262728293031 

    数据统计

    • 访问量: 41543
    • 日志数: 55
    • 图片数: 6
    • 书签数: 1
    • 建立时间: 2007-05-22
    • 更新时间: 2007-12-12

    RSS订阅

    Open Toolbar