OPC Studio User's Guide and Reference
ValueRank Property (UADataVariable)



OpcLabs.ServerOpcUA Assembly > OpcLabs.EasyOpc.UA.NodeSpace Namespace > UADataVariable Class : ValueRank Property
The OPC UA value rank of the variable value.
Syntax
'Declaration
 
Public ReadOnly Property ValueRank As Integer
'Usage
 
Dim instance As UADataVariable
Dim value As Integer
 
value = instance.ValueRank
public int ValueRank {get;}
public:
property int ValueRank {
   int get();
}

Property Value

The value rank, derived from the number of dimensions in ArrayDimensions.

The default value of this property is -1.

Remarks

The value rank indicates whether the variable is a scalar, an array, or a matrix. This property converts the count of array dimensions to an OPC UA value rank.

CAUTION: The notion of value rank in OPC UA, and its numeric values, differ somewhat from the traditional understanding of an array rank. For more information, see OpcLabs.EasyOpc.UA.UAValueRanks.

Only the definite value ranks are supported by this property. Indefinite value ranks, i.e. OpcLabs.EasyOpc.UA.UAValueRanks.Any, OpcLabs.EasyOpc.UA.UAValueRanks.ScalarOrOneDimension, or OpcLabs.EasyOpc.UA.UAValueRanks.OneOrMoreDimensions are not supported.

This method or property does not throw any exceptions, aside from execution exceptions such as System.Threading.ThreadAbortException or System.OutOfMemoryException.

Requirements

Target Platforms: .NET Framework: Windows 10 (selected versions), Windows 11 (selected versions), Windows Server 2016, Windows Server 2022; .NET: Linux, macOS, Microsoft Windows

See Also