Reference

OpcClient.WriteNode Method

Type

OpcClient

Namespace

Opc.UaFx.Client

Assembly

Opc.UaFx.Advanced.dll

Package

Opc.UaFx.Advanced v2.59.0

Members

OpcClient Members

Also in

Opc.UaFx.Client

21 overloads

Overload	Description
WriteNode(OpcNodeId, object)	Writes the value to the Value attribute of the node specified by nodeId.
WriteNode(OpcNodeId, OpcAttribute, object)	Writes the value to the attribute of the node specified by nodeId.
WriteNode(string, object)	Writes the value to the Value attribute of the node specified by nodeId.
WriteNode(string, OpcAttribute, object)	Writes the value to the attribute of the node specified by nodeId.
WriteNode(int, object)	Writes the value to the Value attribute of the node specified by nodeId.
WriteNode(int, OpcAttribute, object)	Writes the value to the attribute of the node specified by nodeId.
WriteNode(string, int, object)	Writes the value to the Value attribute of the node specified by nodeId and namespaceIndex.
WriteNode(string, int, OpcAttribute, object)	Writes the value to the attribute of the node specified by nodeId and namespaceIndex.
WriteNode(int, int, object)	Writes the value to the Value attribute of the node specified by nodeId and namespaceIndex.
WriteNode(int, int, OpcAttribute, object)	Writes the value to the attribute of the node specified by nodeId and namespaceIndex.
WriteNode(OpcNodeId, OpcRange, object)since v2.24	Writes the value into the range of Value attribute of the node specified by nodeId.
WriteNode(OpcNodeId, OpcAttribute, OpcRange, object)since v2.24	Writes the value into the range of attribute of the node specified by nodeId.
WriteNode(string, OpcRange, object)since v2.24	Writes the value into the range of Value attribute of the node specified by nodeId.
WriteNode(string, OpcAttribute, OpcRange, object)since v2.24	Writes the value into the range of attribute of the node specified by nodeId.
WriteNode(int, OpcRange, object)since v2.24	Writes the value into the range of Value attribute of the node specified by nodeId.
WriteNode(int, OpcAttribute, OpcRange, object)since v2.24	Writes the value into the range of attribute of the node specified by nodeId.
WriteNode(string, int, OpcRange, object)since v2.24	Writes the value into the range of Value attribute of the node specified by nodeId and namespaceIndex.
WriteNode(string, int, OpcAttribute, OpcRange, object)since v2.24	Writes the value into the range of attribute of the node specified by nodeId and namespaceIndex.
WriteNode(int, int, OpcRange, object)since v2.24	Writes the value into the range of Value attribute of the node specified by nodeId and namespaceIndex.
WriteNode(int, int, OpcAttribute, OpcRange, object)since v2.24	Writes the value into the range of the attribute of the node specified by nodeId and namespaceIndex.
WriteNode(OpcWriteNode)	Writes one value to one attribute of one node using the specified command.

Exceptions (all overloads)

Exception	Condition
ObjectDisposedException	The object has been disposed of.
OpcException	The service execution failed upon different circumstances; for more details see exception details. The following issues can lead to that exception: BadNothingToDo and BadTooManyOperations.

WriteNode(OpcNodeId, object)

Writes the value to the Value attribute of the node specified by nodeId.

public OpcStatus WriteNode(OpcNodeId nodeId, object value)

Public Function WriteNode(nodeId As OpcNodeId, value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	OpcNodeId	The OpcNodeId of the node to write to.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId indicates to be a null-node-id (see IsNull).
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(OpcNodeId, OpcAttribute, object)

Writes the value to the attribute of the node specified by nodeId.

public OpcStatus WriteNode(
    OpcNodeId nodeId,
    OpcAttribute attribute,
    object value)

Public Function WriteNode(
    nodeId As OpcNodeId,
    attribute As OpcAttribute,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	OpcNodeId	The OpcNodeId of the node to write to.
attribute	OpcAttribute	One of the members defined by the OpcAttribute enumeration that defines which node attribute is to be used by the service.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId indicates to be a null-node-id (see IsNull).
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(string, object)

Writes the value to the Value attribute of the node specified by nodeId.

public OpcStatus WriteNode(string nodeId, object value)

Public Function WriteNode(nodeId As String, value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to write to.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is an empty string.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(string, OpcAttribute, object)

Writes the value to the attribute of the node specified by nodeId.

public OpcStatus WriteNode(string nodeId, OpcAttribute attribute, object value)

Public Function WriteNode(
    nodeId As String,
    attribute As OpcAttribute,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to write to.
attribute	OpcAttribute	One of the members defined by the OpcAttribute enumeration that defines which node attribute is to be used by the service.
value	Object	The data to write to the attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is an empty string.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(int, object)

Writes the value to the Value attribute of the node specified by nodeId.

public OpcStatus WriteNode(int nodeId, object value)

Public Function WriteNode(nodeId As Integer, value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to write to.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals to zero.
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(int, OpcAttribute, object)

Writes the value to the attribute of the node specified by nodeId.

public OpcStatus WriteNode(int nodeId, OpcAttribute attribute, object value)

Public Function WriteNode(
    nodeId As Integer,
    attribute As OpcAttribute,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to write to.
attribute	OpcAttribute	One of the members defined by the OpcAttribute enumeration that defines which node attribute is to be used by the service.
value	Object	The data to write to the attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero.
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(string, int, object)

Writes the value to the Value attribute of the node specified by nodeId and namespaceIndex.

public OpcStatus WriteNode(string nodeId, int namespaceIndex, object value)

Public Function WriteNode(
    nodeId As String,
    namespaceIndex As Integer,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to write to.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is an empty string.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(string, int, OpcAttribute, object)

Writes the value to the attribute of the node specified by nodeId and namespaceIndex.

public OpcStatus WriteNode(
    string nodeId,
    int namespaceIndex,
    OpcAttribute attribute,
    object value)

Public Function WriteNode(
    nodeId As String,
    namespaceIndex As Integer,
    attribute As OpcAttribute,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to write to.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.
attribute	OpcAttribute	One of the members defined by the OpcAttribute enumeration that defines which node attribute is to be used by the service.
value	Object	The data to write to the attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is an empty string.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(int, int, object)

Writes the value to the Value attribute of the node specified by nodeId and namespaceIndex.

public OpcStatus WriteNode(int nodeId, int namespaceIndex, object value)

Public Function WriteNode(
    nodeId As Integer,
    namespaceIndex As Integer,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to write to.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is an empty string.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(int, int, OpcAttribute, object)

Writes the value to the attribute of the node specified by nodeId and namespaceIndex.

public OpcStatus WriteNode(
    int nodeId,
    int namespaceIndex,
    OpcAttribute attribute,
    object value)

Public Function WriteNode(
    nodeId As Integer,
    namespaceIndex As Integer,
    attribute As OpcAttribute,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to write to.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.
attribute	OpcAttribute	One of the members defined by the OpcAttribute enumeration that defines which node attribute is to be used by the service.
value	Object	The data to write to the attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(OpcNodeId, OpcRange, object)

since v2.24

Writes the value into the range of Value attribute of the node specified by nodeId.

public OpcStatus WriteNode(OpcNodeId nodeId, OpcRange range, object value)

Public Function WriteNode(
    nodeId As OpcNodeId,
    range As OpcRange,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	OpcNodeId	The OpcNodeId of the node to write to.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to write.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId indicates to be a null-node-id (see IsNull).
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(OpcNodeId, OpcAttribute, OpcRange, object)

since v2.24

Writes the value into the range of attribute of the node specified by nodeId.

public OpcStatus WriteNode(
    OpcNodeId nodeId,
    OpcAttribute attribute,
    OpcRange range,
    object value)

Public Function WriteNode(
    nodeId As OpcNodeId,
    attribute As OpcAttribute,
    range As OpcRange,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	OpcNodeId	The OpcNodeId of the node to write to.
attribute	OpcAttribute	One of the members defined by the OpcAttribute enumeration that defines which node attribute is to be used by the service.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to write.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId indicates to be a null-node-id (see IsNull).
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(string, OpcRange, object)

since v2.24

Writes the value into the range of Value attribute of the node specified by nodeId.

public OpcStatus WriteNode(string nodeId, OpcRange range, object value)

Public Function WriteNode(
    nodeId As String,
    range As OpcRange,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to write to.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to write.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is an empty string.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(string, OpcAttribute, OpcRange, object)

since v2.24

Writes the value into the range of attribute of the node specified by nodeId.

public OpcStatus WriteNode(
    string nodeId,
    OpcAttribute attribute,
    OpcRange range,
    object value)

Public Function WriteNode(
    nodeId As String,
    attribute As OpcAttribute,
    range As OpcRange,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to write to.
attribute	OpcAttribute	One of the members defined by the OpcAttribute enumeration that defines which node attribute is to be used by the service.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to write.
value	Object	The data to write to the attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is an empty string.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(int, OpcRange, object)

since v2.24

Writes the value into the range of Value attribute of the node specified by nodeId.

public OpcStatus WriteNode(int nodeId, OpcRange range, object value)

Public Function WriteNode(
    nodeId As Integer,
    range As OpcRange,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to write to.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to write.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals to zero.
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(int, OpcAttribute, OpcRange, object)

since v2.24

Writes the value into the range of attribute of the node specified by nodeId.

public OpcStatus WriteNode(
    int nodeId,
    OpcAttribute attribute,
    OpcRange range,
    object value)

Public Function WriteNode(
    nodeId As Integer,
    attribute As OpcAttribute,
    range As OpcRange,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to write to.
attribute	OpcAttribute	One of the members defined by the OpcAttribute enumeration that defines which node attribute is to be used by the service.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to write.
value	Object	The data to write to the attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero.
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(string, int, OpcRange, object)

since v2.24

Writes the value into the range of Value attribute of the node specified by nodeId and namespaceIndex.

public OpcStatus WriteNode(
    string nodeId,
    int namespaceIndex,
    OpcRange range,
    object value)

Public Function WriteNode(
    nodeId As String,
    namespaceIndex As Integer,
    range As OpcRange,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to write to.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to write.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is an empty string.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(string, int, OpcAttribute, OpcRange, object)

since v2.24

Writes the value into the range of attribute of the node specified by nodeId and namespaceIndex.

public OpcStatus WriteNode(
    string nodeId,
    int namespaceIndex,
    OpcAttribute attribute,
    OpcRange range,
    object value)

Public Function WriteNode(
    nodeId As String,
    namespaceIndex As Integer,
    attribute As OpcAttribute,
    range As OpcRange,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to write to.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.
attribute	OpcAttribute	One of the members defined by the OpcAttribute enumeration that defines which node attribute is to be used by the service.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to write.
value	Object	The data to write to the attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is an empty string.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(int, int, OpcRange, object)

since v2.24

Writes the value into the range of Value attribute of the node specified by nodeId and namespaceIndex.

public OpcStatus WriteNode(
    int nodeId,
    int namespaceIndex,
    OpcRange range,
    object value)

Public Function WriteNode(
    nodeId As Integer,
    namespaceIndex As Integer,
    range As OpcRange,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to write to.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to write.
value	Object	The data to write to the Value attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is an empty string.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(int, int, OpcAttribute, OpcRange, object)

since v2.24

Writes the value into the range of the attribute of the node specified by nodeId and namespaceIndex.

public OpcStatus WriteNode(
    int nodeId,
    int namespaceIndex,
    OpcAttribute attribute,
    OpcRange range,
    object value)

Public Function WriteNode(
    nodeId As Integer,
    namespaceIndex As Integer,
    attribute As OpcAttribute,
    range As OpcRange,
    value As Object) As OpcStatus

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to write to.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.
attribute	OpcAttribute	One of the members defined by the OpcAttribute enumeration that defines which node attribute is to be used by the service.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to write.
value	Object	The data to write to the attribute.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the write operation.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the arguments specified.

Remarks

Known results for the operation are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.

WriteNode(OpcWriteNode)

Writes one value to one attribute of one node using the specified command.

public OpcStatus WriteNode(OpcWriteNode command)

Public Function WriteNode(command As OpcWriteNode) As OpcStatus

Parameters

Name	Type	Description
command	OpcWriteNode	The OpcWriteNode instance to process.

Returns

OpcStatus

An instance of the OpcStatus class which indicates the outcome of the operation for the command.

Exceptions

Exception	Condition
ArgumentNullException	The command is a null reference (Nothing in Visual Basic).
InvalidOperationException	The write service is currently not supported, especially using the command specified.

Remarks

Known results for the command specified are:

Status	Description
GoodCompletesAsynchronously	The value was successfully written to an intermediate system but the Server does not know if the data source was updated properly.
BadNodeIdInvalid	For more details see BadNodeIdInvalid.
BadNodeIdUnknown	For more details see BadNodeIdUnknown.
BadAttributeInvalid	For more details see BadAttributeInvalid.
BadIndexRangeInvalid	For more details see BadIndexRangeInvalid.
BadIndexRangeNoData	For more details see BadIndexRangeNoData.
BadWriteNotSupported	The requested write operation is not supported. If a client attempts to write any value, quality, timestamp combination and the server does not support the requested combination (which could be a single quantity such as just timestamp), then the Server shall not perform any write on this node and shall return this status for that node.
BadNotWritable	For more details see BadNotWritable.
BadUserAccessDenied	For more details see BadUserAccessDenied.
BadOutOfRange	If a client attempts to write a value outside the valid range like a value not contained in the enumeration data type of a node, the server shall return this status for that node.
BadTypeMismatch	For more details see BadTypeMismatch.
BadDataEncodingUnsupported	For more details see BadDataEncodingUnsupported.
BadNoCommunication	For more details see BadNoCommunication.