Name Property

Applies to TestComplete 14.40, last modified on April 22, 2021

Description

The Name property returns the name of the dataset described by the given scheme. Usually, the dataset’s name is the caption of the log panel which holds the dataset, for example, Details or Connections.

Declaration

ProgObj.Name

Read-Only Property String
ProgObj An expression, variable or parameter that specifies a reference to one of the objects listed in the Applies To section

Applies To

The property is applied to the following objects:

Property Value

The string holding the dataset’s name.

Example

The code below obtains the name of the specified dataset.

JavaScript, JScript

function LogData()
{
  // Obtains a collection of logs
  var LogsCol = Project.Logs;
  // Obtains the first log item
  var LogItem = LogsCol.LogItem(0);
  // Obtains the first dataset
  // of the specified log item
  var LogData = LogItem.Data(0);
  // Obtains the scheme of the dataset
  var Sch = LogData.Scheme;
  // Obtains the name of the first dataset
  // and posts it to the test log
  var Name = Sch.Name;
  Log.Message("The first dataset's name is: " + Name);
}

Python

def LogData():
  # Obtains a collection of logs
  LogsCol = Project.Logs
  # Obtains the first log item
  LogItem = LogsCol.LogItem[0]
  # Obtains the first dataset
  # of the specified log item
  LogData = LogItem.Data[0]
  # Obtains the scheme of the dataset
  Sch = LogData.Scheme
  # Obtains the name of the first dataset
  # and posts it to the test log
  Name = Sch.Name;
  Log.Message("The first dataset's name is: " + Name)

VBScript

Sub LogData()

  ' Obtains a collection of logs
  Set LogsCol = Project.Logs
  ' Obtains the first log item
  Set LogItem = LogsCol.LogItem(0)
  ' Obtains the first dataset
  ' of the specified log item
  Set LogData = LogItem.Data(0)
  ' Obtains the scheme of the dataset
  Set Sch = LogData.Scheme
  ' Obtains the name of the first dataset
  ' and posts it to the test log
  Name = Sch.Name
  Log.Message("The first dataset's name is: " & Name)
  
End Sub

DelphiScript

function LogData;
var LogsCol, LogItem, LogData, Sch, Name;
begin

  // Obtains a collection of logs
  LogsCol := Project.Logs;
  // Obtains the first log item
  LogItem := LogsCol.LogItem(0);
  // Obtains the first dataset
  // of the specified log item
  LogData := LogItem.Data(0);
  // Obtains the scheme of the dataset
  Sch := LogData.Scheme;
  // Obtains the name of the first dataset
  // and posts it to the test log
  Name := Sch.Name;
  Log.Message('The first dataset''s name is: ' + Name);

end;

C++Script, C#Script

function LogData()
{
  // Obtains a collection of logs
  var LogsCol = Project["Logs"];
  // Obtains the first log item
  var LogItem = LogsCol["LogItem"](0);
  // Obtains the first dataset
  // of the specified log item
  var LogData = LogItem["Data"](0);
  // Obtains the scheme of the dataset
  var Sch = LogData["Scheme"];
  // Obtains the name of the first dataset
  // and posts it to the test log
  var Name = Sch["Name"];
  Log["Message"]("The first dataset's name is: " + Name);
}

See Also

Access Test Log Contents from Tests
Child Property
ChildCount Property
DataType Property

Highlight search results