Namespace: Opc.UaFx.Client
Assemblies: Opc.UaFx.Advanced.dll, Opc.UaFx.Advanced.dll
The OpcNodeInfo type exposes the following members.
Gets the classification of the node using one of the predefined categories.
C#
public OpcNodeCategory Category { get; }
Property Value
One of the members defined by the OpcNodeCategory enumeration.
Remarks
Using a category a node can be classified into different top level kinds of nodes like methods, objects, variables and different types.
Gets the browse setup and context to use to inspect the node, its attributes and its relationships to other nodes.
C#
public OpcBrowseNodeContext Context { get; }
Property Value
An instance of the OpcBrowseNodeContext class which has been initially created using the configuration specified by the initial browse call using the entry node.
Gets the value of the DisplayNameOpcAttribute which defines the localizable name of the node.
C#
public OpcText DisplayName { get; }
Property Value
An instance of the OpcText class which defines the localizable name of the node.
Remarks
Client application should use this attribute if they want to display the name of the node to the user. The String part of the DisplayName is restricted to 512 characters.
Gets the description of the node reference through that the node represented and examined has been located.
C#
public OpcReferenceDescription Reference { get; }
Property Value
An instance of the OpcReferenceDescription class which provides information about the relationship through that the node has been located.
Retrieves the OpcAttributeInfo of the node that has the specified OpcAttribute identifier.
C#
public OpcAttributeInfo Attribute(OpcAttribute attribute)
Parameters
attribute
OpcAttribute
The OpcAttribute identifier of the OpcAttributeInfo to retrieve.
Returns
An OpcAttributeInfo that has the specified OpcAttribute identifier; otherwise a null reference (Nothing in Visual Basic) in case there the server does not provide such an attribute for the node.
Remarks
Although the server may provide an attribute, the Value (= an OpcValue) or its underlying raw value (Value) can be a null reference (Nothing in Visual Basic). Ensure that the Value may needs to be cast into the attribute dependent type.
The time consumed by the first call of the method depends on the availability of the server, because of the attribute is requested on-demand and is cached for subsequent calls. This means, that further attribute requests will take use of already retrieved attribute information and will not demand additional network resources.
To improve the performance to query attributes you may consider the configuration of the attributes to prefetch while browsing the nodes using Attributes.
Retrieves the OpcAttributeInfo of the node that is known using the specified browseName
.
C#
public OpcAttributeInfo Attribute(string browseName)
Parameters
browseName
String
The known browse name of the OpcAttributeInfo to retrieve.
Returns
An OpcAttributeInfo that is known using the specified browseName
; otherwise a null reference (Nothing in Visual Basic) in case there the server does not provide such an attribute for the node.
Exceptions
The browseName
is an empty string.
The browseName
is a null reference (Nothing in Visual Basic).
Remarks
Although the server may provide an attribute, the Value (= an OpcValue) or its underlying raw value (Value) can be a null reference (Nothing in Visual Basic). Ensure that the Value may needs to be cast into the attribute dependent type.
The time consumed by the first call of the method depends on the availability of the server, because of the attribute is requested on-demand and is cached for subsequent calls. This means, that further attribute requests will take use of already retrieved attribute information and will not demand additional network resources.
To improve the performance to query attributes you may consider the configuration of the attributes to prefetch while browsing the nodes using Attributes.
Retrieves for each OpcAttribute identifier the according OpcAttributeInfo of the node.
C#
public IEnumerable<OpcAttributeInfo> Attributes()
Returns
A sequence of OpcAttributeInfo instances which provides the attribute identifier and attribute value of all in general defined node attributes (see OpcAttribute).
Remarks
Although the server may provide an attribute, the Value (= an OpcValue) or its underlying raw value (Value) can be a null reference (Nothing in Visual Basic). Ensure that the Value may needs to be cast into the attribute dependent type.
The time consumed by the first call of the method depends on the availability of the server, because of the attributes are requested on-demand and are cached for subsequent calls. This means, that further attribute requests will take use of already retrieved attribute information and will not demand additional network resources.
To improve the performance to query attributes you may consider the configuration of the attributes to prefetch while browsing the nodes using Attributes.
Retrieves for each OpcAttribute identifier specified by attributes
the according OpcAttributeInfo of the node.
C#
public IEnumerable<OpcAttributeInfo> Attributes(IEnumerable<OpcAttribute> attributes)
Parameters
attributes
IEnumerable<OpcAttribute>
A sequence of OpcAttribute identifiers of the OpcAttributeInfo instances to retrieve.
Returns
A sequence of OpcAttributeInfo instances which provides the attribute identifier and attribute value of the node attributes specified by the OpcAttribute identifiers defined by attributes
.
Exceptions
The attributes
sequence is a null reference (Nothing in Visual Basic).
Remarks
Although the server may provide an attribute, the Value (= an OpcValue) or its underlying raw value (Value) can be a null reference (Nothing in Visual Basic). Ensure that the Value may needs to be cast into the attribute dependent type.
The time consumed by the first call of the method depends on the availability of the server, because of the attributes are requested on-demand and are cached for subsequent calls. This means, that further attribute requests will take use of already retrieved attribute information and will not demand additional network resources.
To improve the performance to query attributes you may consider the configuration of the attributes to prefetch while browsing the nodes using Attributes.
Retrieves the OpcAttributeInfo of the node that is known using the specified browseNames
.
C#
public IEnumerable<OpcAttributeInfo> Attributes(IEnumerable<string> browseNames)
Parameters
browseNames
IEnumerable<String>
A sequence of known browse names of the OpcAttributeInfo to retrieve.
Returns
A sequence of OpcAttributeInfo instances which provides the attribute identifier and attribute value of the node attributes specified by the browseNames
passed.
Exceptions
The browseNames
array is a null reference (Nothing in Visual Basic).
Remarks
Although the server may provide an attribute, the Value (= an OpcValue) or its underlying raw value (Value) can be a null reference (Nothing in Visual Basic). Ensure that the Value may needs to be cast into the attribute dependent type.
The time consumed by the first call of the method depends on the availability of the server, because of the attributes are requested on-demand and are cached for subsequent calls. This means, that further attribute requests will take use of already retrieved attribute information and will not demand additional network resources.
To improve the performance to query attributes you may consider the configuration of the attributes to prefetch while browsing the nodes using Attributes.
Retrieves for each OpcAttribute identifier specified by attributes
the according OpcAttributeInfo of the node.
C#
public IEnumerable<OpcAttributeInfo> Attributes(params OpcAttribute[] attributes)
Parameters
attributes
OpcAttribute[]
An array of OpcAttribute identifiers of the OpcAttributeInfo instances to retrieve.
Returns
An array of OpcAttributeInfo instances which provides the attribute identifier and attribute value of the node attributes specified by the OpcAttribute identifiers defined by attributes
.
Exceptions
The attributes
array is a null reference (Nothing in Visual Basic).
Remarks
Although the server may provide an attribute, the Value (= an OpcValue) or its underlying raw value (Value) can be a null reference (Nothing in Visual Basic). Ensure that the Value may needs to be cast into the attribute dependent type.
The time consumed by the first call of the method depends on the availability of the server, because of the attributes are requested on-demand and are cached for subsequent calls. This means, that further attribute requests will take use of already retrieved attribute information and will not demand additional network resources.
To improve the performance to query attributes you may consider the configuration of the attributes to prefetch while browsing the nodes using Attributes.
Retrieves the OpcAttributeInfo of the node that is known using the specified browseNames
.
C#
public IEnumerable<OpcAttributeInfo> Attributes(params string[] browseNames)
Parameters
browseNames
String[]
An array of known browse names of the OpcAttributeInfo to retrieve.
Returns
A sequence of OpcAttributeInfo instances which provides the attribute identifier and attribute value of the node attributes specified by the browseNames
passed.
Exceptions
The browseNames
array is a null reference (Nothing in Visual Basic).
Remarks
Although the server may provide an attribute, the Value (= an OpcValue) or its underlying raw value (Value) can be a null reference (Nothing in Visual Basic). Ensure that the Value may needs to be cast into the attribute dependent type.
The time consumed by the first call of the method depends on the availability of the server, because of the attributes are requested on-demand and are cached for subsequent calls. This means, that further attribute requests will take use of already retrieved attribute information and will not demand additional network resources.
To improve the performance to query attributes you may consider the configuration of the attributes to prefetch while browsing the nodes using Attributes.
Retrieves the value of the attribute
specified.
C#
public object AttributeValue(OpcAttribute attribute)
Parameters
attribute
OpcAttribute
One of the members defined by the OpcAttribute enumeration which identifies the attribute its value is queried.
Returns
The value of the attribute
specified or a null reference (Nothing in Visual Basic) in case there the value of the attribute is a null reference or it is not supported by the current OpcNodeInfo.
Remarks
The time consumed by the first call of the method depends on the availability of the server, because of the attribute is requested on-demand and is cached for subsequent calls. This means, that further attribute requests will take use of already retrieved attribute information and will not demand additional network resources.
To improve the performance to query attributes you may consider the configuration of the attributes to prefetch while browsing the nodes using Attributes.
Retrieves the value of the attribute
specified.
C#
public T AttributeValue<T>(OpcAttribute attribute)
Parameters
attribute
OpcAttribute
One of the members defined by the OpcAttribute enumeration which identifies the attribute its value is queried.
Returns
The value of the attribute
as the type T
specified or the default value of the type T
in case there the value of the attribute is a null reference (Nothing in Visual Basic) or it is not supported by the current OpcNodeInfo.
Remarks
The time consumed by the first call of the method depends on the availability of the server, because of the attribute is requested on-demand and is cached for subsequent calls. This means, that further attribute requests will take use of already retrieved attribute information and will not demand additional network resources.
To improve the performance to query attributes you may consider the configuration of the attributes to prefetch while browsing the nodes using Attributes.
Retrieves the OpcNodeInfo of the child node that is known using the specified name
of the node.
C#
public OpcNodeInfo Child(string name)
Parameters
name
String
The nominal information of the child node to retrieve.
Returns
An OpcNodeInfo that is known using the specified name
; otherwise a null reference (Nothing in Visual Basic) in case there the server does not provide such a child node for the node.
Exceptions
The name
is a null reference (Nothing in Visual Basic).
Remarks
The time consumed by the first call of the method depends on the availability of the server, because of the child is requested on-demand and is cached for subsequent calls. This means, that further child requests will take use of already retrieved child information and will not demand additional network resources.
Retrieves for each child node of the node represented the according OpcNodeInfo.
C#
public IEnumerable<OpcNodeInfo> Children()
Returns
A sequence of OpcNodeInfo instances which provides the node information of all nodes referenced as child (see OpcNodeInfo).
Remarks
The time consumed by the first call of the method depends on the availability of the server, because of the nodes are requested on-demand and are cached for subsequent calls. This means, that further child requests will take use of already retrieved child information and will not demand additional network resources.
Retrieves for each child node of the category
specified of the node represented the according OpcNodeInfo.
C#
public IEnumerable<OpcNodeInfo> Children(OpcNodeCategory category)
Parameters
category
OpcNodeCategory
One of the members defined by the OpcNodeCategory enumeration which defines the classification of the child nodes to retrieve or a combination of the members.
Returns
A sequence of OpcNodeInfo instances which provides the node information of all nodes referenced as child of the category
specified.
Remarks
The time consumed by the first call of the method depends on the availability of the server, because of the nodes are requested on-demand and are cached for subsequent calls. This means, that further child requests will take use of already retrieved child information and will not demand additional network resources.
Retrieves for each child node referenced using the referenceType
specified the according OpcNodeInfo.
C#
public IEnumerable<OpcNodeInfo> Children(OpcReferenceType referenceType)
Parameters
referenceType
OpcReferenceType
One of the members defined by the OpcReferenceType enumeration which defines the type of reference between the node represented and child nodes to retrieve.
Returns
A sequence of OpcNodeInfo instances which provides the node information of all nodes referenced as child using the referenceType
specified.
Remarks
The time consumed by the first call of the method depends on the availability of the server, because of the nodes are requested on-demand and are cached for subsequent calls. This means, that further child requests will take use of already retrieved child information and will not demand additional network resources.
In case there the referenceType
specified is not part of the reference types browsed using the Context of the current OpcNodeInfo (see ReferenceTypeIds) there is separate browse operation performed to query the children requested. In this case the child nodes are not cached and are re-queried on every call to this method.
Retrieves the OpcNodeInfo of the parent node that is known using the specified name
of the node.
C#
public OpcNodeInfo Parent(string name)
Parameters
name
String
The nominal information of the parent node to retrieve.
Returns
An OpcNodeInfo that is known using the specified name
; otherwise a null reference (Nothing in Visual Basic) in case there the server does not provide such a parent node for the node.
Exceptions
The name
is a null reference (Nothing in Visual Basic).
Remarks
The time consumed by the first call of the method depends on the availability of the server, because of the parent is requested on-demand and is cached for subsequent calls. This means, that further parent requests will take use of already retrieved parent information and will not demand additional network resources.
Retrieves for each parent node of the node represented the according OpcNodeInfo.
C#
public IEnumerable<OpcNodeInfo> Parents()
Returns
A sequence of OpcNodeInfo instances which provides the node information of all nodes referenced as parent (see OpcNodeInfo).
Remarks
The time consumed by the first call of the method depends on the availability of the server, because of the nodes are requested on-demand and are cached for subsequent calls. This means, that further parent requests will take use of already retrieved parent information and will not demand additional network resources.
Retrieves for each parent node of the category
specified of the node represented the according OpcNodeInfo.
C#
public IEnumerable<OpcNodeInfo> Parents(OpcNodeCategory category)
Parameters
category
OpcNodeCategory
One of the members defined by the OpcNodeCategory enumeration which defines the classification of the parent nodes to retrieve or a combination of the members.
Returns
A sequence of OpcNodeInfo instances which provides the node information of all nodes referenced as parent of the category
specified.
Remarks
The time consumed by the first call of the method depends on the availability of the server, because of the nodes are requested on-demand and are cached for subsequent calls. This means, that further parent requests will take use of already retrieved parent information and will not demand additional network resources.
Retrieves for each parent node referenced using the referenceType
specified the according OpcNodeInfo.
C#
public IEnumerable<OpcNodeInfo> Parents(OpcReferenceType referenceType)
Parameters
referenceType
OpcReferenceType
One of the members defined by the OpcReferenceType enumeration which defines the type of reference between the node represented and parent nodes to retrieve.
Returns
A sequence of OpcNodeInfo instances which provides the node information of all nodes referenced as parent using the referenceType
specified.
Remarks
The time consumed by the first call of the method depends on the availability of the server, because of the nodes are requested on-demand and are cached for subsequent calls. This means, that further child requests will take use of already retrieved child information and will not demand additional network resources.
In case there the referenceType
specified is not part of the reference types browsed using the Context of the current OpcNodeInfo (see ReferenceTypeIds) there is separate browse operation performed to query the parents requested. In this case the parent nodes are not cached and are re-queried on every call to this method.