Reference

OpcClient.WriteNodeValues 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

2 overloads · since v2.8

Overload	Description
WriteNodeValues(IEnumerable<OpcNodeValuePair>)since v2.8	Writes the Value attributes using the nodes and values in the nodeValues specified.
WriteNodeValues(params OpcNodeValuePair[])since v2.8	Writes the Value attributes using the nodeValues specified.

Exceptions (all overloads)

Exception	Condition
InvalidOperationException	The write service is currently not supported, especially using the nodeValues specified.
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.

WriteNodeValues(IEnumerable<OpcNodeValuePair>)

since v2.8

Writes the Value attributes using the nodes and values in the nodeValues specified.

public OpcStatusCollection WriteNodeValues(
    IEnumerable<OpcNodeValuePair> nodeValues)

Public Function WriteNodeValues(
    nodeValues As IEnumerable(Of OpcNodeValuePair)) As OpcStatusCollection

Parameters

Name	Type	Description
nodeValues	IEnumerable<OpcNodeValuePair>	A sequence of OpcNodeValuePair items which represents the nodes its Value is to be written using the further defined values.

Returns

OpcStatusCollection

An instance of the OpcStatusCollection its number and order of items matches the number and order of items in the nodeValues sequence. There is for each item one entry which indicates the outcome of the operation for the OpcNodeValuePair item.

Exceptions

Exception	Condition
ArgumentNullException	The nodeValues sequence or one of its items is a null reference (Nothing in Visual Basic).

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.

WriteNodeValues(params OpcNodeValuePair[])

since v2.8

Writes the Value attributes using the nodeValues specified.

public OpcStatusCollection WriteNodeValues(params OpcNodeValuePair[] nodeValues)

Public Function WriteNodeValues(
    ParamArray nodeValues As OpcNodeValuePair()) As OpcStatusCollection

Parameters

Name	Type	Description
nodeValues	params OpcNodeValuePair[]	An array of OpcNodeValuePair items representing the nodes and values which are written to their Value attribute.

Returns

OpcStatusCollection

An instance of the OpcStatusCollection its number and order of items matches the number and order of items in the nodeValues array. There is for each entry in nodeValues one entry which indicates the outcome of the operation for that node.

Exceptions

Exception	Condition
ArgumentNullException	The nodeValues array or one of its items is a null reference (Nothing in Visual Basic).

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.