CATable::GetDataByLabels/zh

ADE User Guide > ADE Server Class Reference > CATable

CATable::GetDataByLabels(indexLabels)

Retrieves the value of an input table cell according to «indexLabels», which specify the label for each index of the table in order.

The parameter specifies the coordinates of a cell in the table, using the index labels (CATable::GetDataByElements does the same using index position). When the table is one dimensional, indexLabels can be a single value -- a text value when the index is a list-of-labels, or a number when the index is a numeric list. Otherwise, indexLabels must be an array with N elements when the table is N-dimensional.

The order of the dimensions, as they are listed in «indexLabels», is determined by a previous call to CATable::SetIndexOrder.

The return value is the value of the table cell. The manner in which this value is returned is determined by the CATable::RenderingStyle.

When the result table is zero-dimensional (i.e., atomic, not an array), you must use CATable::AtomicValue to access the value.

示例

在VB中

dim editTab as CATable = var2d.DefTable

dim indexLabs(1)   ' Contains two elements, (0) and (1)
indexLabs(0) = 3
indexLabs(1) = "green"
editTab.SetIndexOrder( Split("I,J",",") )

ET = editTab.GetDataByLabels(indexLabs)

dim resTab as CATable = var2d.ResultTable
resTab.SetIndexOrder( Split("I,J",","))
RT = resultTab.GetDataByLabels(indexLabs)

RT1 = var1d.ResultTable.GetDataByLabels("red")

错误代码

24 – “Subscripts must be an array of variants”

25 – “Subscripts cannot be accessed”

26 – “Lower bound of subscript array inaccessible”

27 – “Upper bound of subscript array inaccessible”

28 – “Must specify at least one element in table”

30 – “Position does not exist”

另请参考

• CATable::SetIndexOrder
• CATable::RenderingStyle and CARenderingStyle
• CATable::GetDataByElements
• CATable::AtomicValue
• CATable::GetSafeArray
• CATable::SetDataByLabels和 CATable::SetDataByElements
• CATable::Subscript和 CATable::Slice