Skip to content

Reference

IOpcAddNodesService Members

Defines a specialized IOpcService<TResponse, TRequest> which can be used to add one or more nodes into the address space hierarchy.

Reference

IOpcAddNodesService Members ​

Type
IOpcAddNodesService
Namespace
Opc.UaFx.Services
Assembly
Opc.UaFx.Advanced.dll
Package
Opc.UaFx.Advanced v2.59.0
Also in
Opc.UaFx.Client

Inherits members from IOpcService<OpcAddNodesResponse, OpcAddNodesRequest>.

Methods ​

AddNodes ​

2 overloads · since v2.7

OverloadDescription
AddNodes(IEnumerable<OpcAddNode>)since v2.7Adds one or more nodes into the address space hierarchy using the commands specified.
AddNodes(params OpcAddNode[])since v2.7Adds one or more nodes into the address space hierarchy using the commands specified.

Exceptions (all overloads)

ExceptionCondition
ArgumentNullExceptionThe commands sequence or one of its items is a null reference (Nothing in Visual Basic).
InvalidOperationExceptionThe add node service is currently not supported, especially using the commands specified.
OpcExceptionThe service execution failed upon different circumstances; for more details see exception details. The following issues can lead to that exception: BadNothingToDo and BadTooManyOperations.

AddNodes(IEnumerable<OpcAddNode>) ​

since v2.7

Adds one or more nodes into the address space hierarchy using the commands specified.

csharp
OpcAddNodeResultCollection AddNodes(IEnumerable<OpcAddNode> commands)
vbnet
Function AddNodes(
    commands As IEnumerable(Of OpcAddNode)) As OpcAddNodeResultCollection

Parameters

NameTypeDescription
commandsIEnumerable<OpcAddNode>A sequence of OpcAddNode instances to process.

Returns

OpcAddNodeResultCollection

An instance of the OpcAddNodeResultCollection class which contains the node identifiers used or created for the nodes added through the commands specified; together with information about the outcome of each processed command.

Remarks

Known results for the commands specified are:

StatusDescription
BadParentNodeIdInvalidThe parent node id does not refer to a valid node.
BadReferenceTypeIdInvalidFor more details see BadReferenceTypeIdInvalid.
BadReferenceNotAllowedThe reference could not be created because it violates constraints imposed by the data model.
BadNodeIdRejectedThe requested node id is already used by another node.
BadNodeClassInvalidFor more details see BadNodeClassInvalid.
BadBrowseNameInvalidFor more details see BadBrowseNameInvalid.
BadBrowseNameDuplicatedThe browse name is not unique among nodes that share the same relationship with the parent.
BadNodeAttributesInvalidThe node attributes are not valid for the node class.
BadTypeDefinitionInvalidFor more details see BadTypeDefinitionInvalid.
BadUserAccessDeniedFor more details see BadUserAccessDenied.

AddNodes(params OpcAddNode[]) ​

since v2.7

Adds one or more nodes into the address space hierarchy using the commands specified.

csharp
OpcAddNodeResultCollection AddNodes(params OpcAddNode[] commands)
vbnet
Function AddNodes(
    ParamArray commands As OpcAddNode()) As OpcAddNodeResultCollection

Parameters

NameTypeDescription
commandsparams OpcAddNode[]An array of OpcAddNode instances to process.

Returns

OpcAddNodeResultCollection

An instance of the OpcAddNodeResultCollection class which contains the node identifiers used or created for the nodes added through the commands specified; together with information about the outcome of each processed command.

Remarks

Known results for the commands specified are:

StatusDescription
BadParentNodeIdInvalidThe parent node id does not refer to a valid node.
BadReferenceTypeIdInvalidFor more details see BadReferenceTypeIdInvalid.
BadReferenceNotAllowedThe reference could not be created because it violates constraints imposed by the data model.
BadNodeIdRejectedThe requested node id is already used by another node.
BadNodeClassInvalidFor more details see BadNodeClassInvalid.
BadBrowseNameInvalidFor more details see BadBrowseNameInvalid.
BadBrowseNameDuplicatedThe browse name is not unique among nodes that share the same relationship with the parent.
BadNodeAttributesInvalidThe node attributes are not valid for the node class.
BadTypeDefinitionInvalidFor more details see BadTypeDefinitionInvalid.
BadUserAccessDeniedFor more details see BadUserAccessDenied.