Reference
OpcAddReference Members
Defines a single command of the IOpcAddReferencesService used to add a logical reference between one and another node.
Reference
OpcAddReference Members
- Type
- OpcAddReference
- Namespace
- Opc.UaFx
- Assembly
- Opc.UaFx.Advanced.dll
- Package
- Opc.UaFx.Advanced v2.59.0
- Also in
- Opc.UaFx.Client
Inherits members from OpcNodeServiceCommand, OpcServiceCommand.
Constructors
OpcAddReference
| Overload | Description |
|---|---|
| OpcAddReference( | Initializes a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other. |
| OpcAddReference( | Initializes a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. |
| OpcAddReference( | Initializes a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. |
| OpcAddReference( | Initializes a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. |
OpcAddReference(OpcNodeId, OpcNodeId, OpcNodeCategory)
Initializes a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other. The new reference will be a ParentToChild relation using Organizes as the type of reference.
public OpcAddReference(
OpcNodeId nodeId,
OpcNodeId targetNodeId,
OpcNodeCategory targetNodeCategory)Public Sub New(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId,
targetNodeCategory As OpcNodeCategory)Parameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. This identifier refers to the 'child' node. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target node can be identified and accessed. This identifier referes to the 'parent' node. |
target | OpcNodeCategory | One of the members defined by the OpcNodeCategory enumeration which is used by the server to validate that the reference to be added matches the OpcNodeCategory of the target node identified by the targetNodeId. |
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId or targetNodeId is equals Null. |
| Argument | The nodeId or targetNodeId is a null reference ( |
OpcAddReference(OpcNodeId, OpcNodeId, OpcNodeCategory, OpcReferenceDirection)
Initializes a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. The new reference will use the relation defined by direction using the Organizes as the type of reference.
public OpcAddReference(
OpcNodeId nodeId,
OpcNodeId targetNodeId,
OpcNodeCategory targetNodeCategory,
OpcReferenceDirection direction)Public Sub New(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId,
targetNodeCategory As OpcNodeCategory,
direction As OpcReferenceDirection)Parameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target node can be identified and accessed. |
target | OpcNodeCategory | One of the members defined by the OpcNodeCategory enumeration which is used by the server to validate that the reference to be added matches the OpcNodeCategory of the target node identified by the targetNodeId. |
direction | Opc | One of the members defined by the Opc |
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId or targetNodeId is equals Null. |
| Argument | The nodeId or targetNodeId is a null reference ( |
OpcAddReference(OpcNodeId, OpcNodeId, OpcNodeCategory, OpcReferenceDirection, OpcReferenceType)
Initializes a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. The new reference will use the relation defined by direction using the referenceType specified as the type of reference.
public OpcAddReference(
OpcNodeId nodeId,
OpcNodeId targetNodeId,
OpcNodeCategory targetNodeCategory,
OpcReferenceDirection direction,
OpcReferenceType referenceType)Public Sub New(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId,
targetNodeCategory As OpcNodeCategory,
direction As OpcReferenceDirection,
referenceType As OpcReferenceType)Parameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target node can be identified and accessed. |
target | OpcNodeCategory | One of the members defined by the OpcNodeCategory enumeration which is used by the server to validate that the reference to be added matches the OpcNodeCategory of the target node identified by the targetNodeId. |
direction | Opc | One of the members defined by the Opc |
referenceType | OpcReferenceType | One of the members defined by the OpcReferenceType enumeration to use to setup the reference between the source and the target node identified by the nodeId and the targetNodeId. |
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId or targetNodeId is equals Null. |
| Argument | The nodeId or targetNodeId is a null reference ( |
OpcAddReference(OpcNodeId, OpcNodeId, OpcNodeCategory, OpcReferenceDirection, OpcNodeId)
Initializes a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. The new reference will use the relation defined by direction using the type of reference identified by the referenceTypeId specified.
public OpcAddReference(
OpcNodeId nodeId,
OpcNodeId targetNodeId,
OpcNodeCategory targetNodeCategory,
OpcReferenceDirection direction,
OpcNodeId referenceTypeId)Public Sub New(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId,
targetNodeCategory As OpcNodeCategory,
direction As OpcReferenceDirection,
referenceTypeId As OpcNodeId)Parameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target node can be identified and accessed. |
target | OpcNodeCategory | One of the members defined by the OpcNodeCategory enumeration which is used by the server to validate that the reference to be added matches the OpcNodeCategory of the target node identified by the targetNodeId. |
direction | Opc | One of the members defined by the Opc |
referenceTypeId | OpcNodeId | The OpcNodeId which identifies the type of reference to use to setup the reference between the source and the target node identified by the nodeId and the targetNodeId. |
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId, targetNodeId or referenceTypeId is a null reference ( |
Properties
Direction
Gets a value indicating the logical direction of the reference to add.
public OpcReferenceDirection Direction { get; }Public ReadOnly Property Direction As OpcReferenceDirectionProperty value
One of the members defined by the OpcReferenceDirection enumeration. The default value is ParentToChild.
ReferenceType
Gets a value which defines a pre-defined used ReferenceTypeId as one of the members defined by the OpcReferenceType enumeration to simplify querying standard reference types.
public OpcReferenceType ReferenceType { get; }Public ReadOnly Property ReferenceType As OpcReferenceTypeProperty value
One of the members defined by the OpcReferenceType enumeration. The default value is Organizes.
ReferenceTypeId
Gets the identifier which identifies the node that defines the semantic of the reference between the source and the target node and generally reflects an operation between the two, such as "A contains B".
public OpcNodeId ReferenceTypeId { get; }Public ReadOnly Property ReferenceTypeId As OpcNodeIdProperty value
The OpcNodeId of the reference type node which defines the relation semantic between the source and the target node. The default value is Organizes.
TargetNodeCategory
Gets the OpcNodeCategory of the target node identified by TargetNodeId. The client shall define the concrete category of node the TargetNodeId refers to, since the target node might not be accessible directly by the server. Additionally the server uses the category to validate that the reference to be added matches the category of node of the target node identified by the TargetNodeId.
public OpcNodeCategory TargetNodeCategory { get; }Public ReadOnly Property TargetNodeCategory As OpcNodeCategoryProperty value
One of the members defined by the OpcNodeCategory enumeration which defines the category of node of the target node to reference.
TargetNodeId
Gets the identifier which identifies the target node which acts as the opponent in the reference to construct between the source node (identified by NodeId) the target node.
public OpcNodeId TargetNodeId { get; }Public ReadOnly Property TargetNodeId As OpcNodeIdProperty value
The OpcNodeId of the target node acting as the opponent of the reference to add.
TargetServerUri
Gets or sets the Uri of the remote server which provides the node identified by TargetNodeId.
public Uri TargetServerUri { get; set; }Public Property TargetServerUri As UriProperty value
An instance of the Uri class which provides the full qualified resource identifier to access the server of the target node identified by the TargetNodeId or a null reference (Nothing in Visual Basic) if the command receiving server shall execute this command (the default value).
Methods
ToObject
| Overload | Description |
|---|---|
| ToObject( | Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other. |
| ToObject( | Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. |
| ToObject( | Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. |
| ToObject( | Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. |
ToObject(OpcNodeId, OpcNodeId)
Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other. The new reference will be a ParentToChild relation using Organizes as the type of reference while the target node shall be a node of the category Object.
public static OpcAddReference ToObject(OpcNodeId nodeId, OpcNodeId targetNodeId)Public Shared Function ToObject(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId) As OpcAddReferenceParameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. This identifier refers to the 'child' node. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target object node can be identified and accessed. This identifier referes to the 'parent' node. |
Returns
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId or targetNodeId is equals Null. |
| Argument | The nodeId or targetNodeId is a null reference ( |
ToObject(OpcNodeId, OpcNodeId, OpcReferenceDirection)
Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. The new reference will use the relation defined by direction using the Organizes as the type of reference while the target node shall be a node of the category Object.
public static OpcAddReference ToObject(
OpcNodeId nodeId,
OpcNodeId targetNodeId,
OpcReferenceDirection direction)Public Shared Function ToObject(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId,
direction As OpcReferenceDirection) As OpcAddReferenceParameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target object node can be identified and accessed. |
direction | Opc | One of the members defined by the Opc |
Returns
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId or targetNodeId is equals Null. |
| Argument | The nodeId or targetNodeId is a null reference ( |
ToObject(OpcNodeId, OpcNodeId, OpcReferenceDirection, OpcReferenceType)
Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. The new reference will use the relation defined by direction using the referenceType specified as the type of reference while the target node shall be a node of the category Object.
public static OpcAddReference ToObject(
OpcNodeId nodeId,
OpcNodeId targetNodeId,
OpcReferenceDirection direction,
OpcReferenceType referenceType)Public Shared Function ToObject(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId,
direction As OpcReferenceDirection,
referenceType As OpcReferenceType) As OpcAddReferenceParameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target object node can be identified and accessed. |
direction | Opc | One of the members defined by the Opc |
referenceType | OpcReferenceType | One of the members defined by the OpcReferenceType enumeration to use to setup the reference between the source and the target node identified by the nodeId and the targetNodeId. |
Returns
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId or targetNodeId is equals Null. |
| Argument | The nodeId or targetNodeId is a null reference ( |
ToObject(OpcNodeId, OpcNodeId, OpcReferenceDirection, OpcNodeId)
Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. The new reference will use the relation defined by direction using the type of reference identified by the referenceTypeId specified while the target node shall be a node of the category Object.
public static OpcAddReference ToObject(
OpcNodeId nodeId,
OpcNodeId targetNodeId,
OpcReferenceDirection direction,
OpcNodeId referenceTypeId)Public Shared Function ToObject(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId,
direction As OpcReferenceDirection,
referenceTypeId As OpcNodeId) As OpcAddReferenceParameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target object node can be identified and accessed. |
direction | Opc | One of the members defined by the Opc |
referenceTypeId | OpcNodeId | The OpcNodeId which identifies the type of reference to use to setup the reference between the source and the target node identified by the nodeId and the targetNodeId. |
Returns
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId, targetNodeId or referenceTypeId is equals Null. |
| Argument | The nodeId, targetNodeId or referenceTypeId is a null reference ( |
ToVariable
| Overload | Description |
|---|---|
| ToVariable( | Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other. |
| ToVariable( | Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. |
| ToVariable( | Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. |
| ToVariable( | Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. |
ToVariable(OpcNodeId, OpcNodeId)
Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other. The new reference will be a ParentToChild relation using Organizes as the type of reference while the target node shall be a node of the category Variable.
public static OpcAddReference ToVariable(
OpcNodeId nodeId,
OpcNodeId targetNodeId)Public Shared Function ToVariable(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId) As OpcAddReferenceParameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. This identifier refers to the 'child' node. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target variable node can be identified and accessed. This identifier referes to the 'parent' node. |
Returns
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId or targetNodeId is equals Null. |
| Argument | The nodeId or targetNodeId is a null reference ( |
ToVariable(OpcNodeId, OpcNodeId, OpcReferenceDirection)
Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. The new reference will use the relation defined by direction using the Organizes as the type of reference while the target node shall be a node of the category Variable.
public static OpcAddReference ToVariable(
OpcNodeId nodeId,
OpcNodeId targetNodeId,
OpcReferenceDirection direction)Public Shared Function ToVariable(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId,
direction As OpcReferenceDirection) As OpcAddReferenceParameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target variable node can be identified and accessed. |
direction | Opc | One of the members defined by the Opc |
Returns
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId or targetNodeId is equals Null. |
| Argument | The nodeId or targetNodeId is a null reference ( |
ToVariable(OpcNodeId, OpcNodeId, OpcReferenceDirection, OpcReferenceType)
Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. The new reference will use the relation defined by direction using the referenceType specified as the type of reference while the target node shall be a node of the category Variable.
public static OpcAddReference ToVariable(
OpcNodeId nodeId,
OpcNodeId targetNodeId,
OpcReferenceDirection direction,
OpcReferenceType referenceType)Public Shared Function ToVariable(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId,
direction As OpcReferenceDirection,
referenceType As OpcReferenceType) As OpcAddReferenceParameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target variable node can be identified and accessed. |
direction | Opc | One of the members defined by the Opc |
referenceType | OpcReferenceType | One of the members defined by the OpcReferenceType enumeration to use to setup the reference between the source and the target node identified by the nodeId and the targetNodeId. |
Returns
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId or targetNodeId is equals Null. |
| Argument | The nodeId or targetNodeId is a null reference ( |
ToVariable(OpcNodeId, OpcNodeId, OpcReferenceDirection, OpcNodeId)
Creates a new instance of the OpcAddReference class using the identifiers of the nodes which shall reference each other using the direction specified. The new reference will use the relation defined by direction using the type of reference identified by the referenceTypeId specified while the target node shall be a node of the category Variable.
public static OpcAddReference ToVariable(
OpcNodeId nodeId,
OpcNodeId targetNodeId,
OpcReferenceDirection direction,
OpcNodeId referenceTypeId)Public Shared Function ToVariable(
nodeId As OpcNodeId,
targetNodeId As OpcNodeId,
direction As OpcReferenceDirection,
referenceTypeId As OpcNodeId) As OpcAddReferenceParameters
| Name | Type | Description |
|---|---|---|
nodeId | OpcNodeId | The OpcNodeId through that the source node can be identified and accessed. |
targetNodeId | OpcNodeId | The OpcNodeId through that the target variable node can be identified and accessed. |
direction | Opc | One of the members defined by the Opc |
referenceTypeId | OpcNodeId | The OpcNodeId which identifies the type of reference to use to setup the reference between the source and the target node identified by the nodeId and the targetNodeId. |
Returns
Exceptions
| Exception | Condition |
|---|---|
| Argument | The nodeId, targetNodeId or referenceTypeId is equals Null. |
| Argument | The nodeId, targetNodeId or referenceTypeId is a null reference ( |

