Reference

OpcClient.ReadNode 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
ReadNode(OpcNodeId)	Reads the Value attribute of the node specified by nodeId.
ReadNode(OpcNodeId, OpcAttribute)	Reads the attribute of the node specified by nodeId.
ReadNode(string)	Reads the Value attribute of the node specified by nodeId.
ReadNode(string, OpcAttribute)	Reads the attribute of the node specified by nodeId.
ReadNode(int)	Reads the Value attribute of the node specified by nodeId.
ReadNode(int, OpcAttribute)	Reads the attribute of the node specified by nodeId.
ReadNode(string, int)	Reads the Value attribute of the node specified by nodeId and namespaceIndex.
ReadNode(string, int, OpcAttribute)	Reads the attribute of the node specified by nodeId and namespaceIndex.
ReadNode(int, int)	Reads the Value attribute of the node specified by nodeId and namespaceIndex.
ReadNode(int, int, OpcAttribute)	Reads the attribute of the node specified by nodeId and namespaceIndex.
ReadNode(OpcReadNode)	Reads the value of an attribute of a node using the specified command.
ReadNode(OpcNodeId, OpcRange)since v2.24	Reads the range from the Value attribute of the node specified by nodeId.
ReadNode(OpcNodeId, OpcAttribute, OpcRange)since v2.24	Reads the range from the attribute of the node specified by nodeId.
ReadNode(string, OpcRange)since v2.24	Reads the range from the Value attribute of the node specified by nodeId.
ReadNode(string, OpcAttribute, OpcRange)since v2.24	Reads the range from the attribute of the node specified by nodeId.
ReadNode(int, OpcRange)since v2.24	Reads the range from the Value attribute of the node specified by nodeId.
ReadNode(int, OpcAttribute, OpcRange)since v2.24	Reads the range from the attribute of the node specified by nodeId.
ReadNode(string, int, OpcRange)since v2.24	Reads the range from the Value attribute of the node specified by nodeId and namespaceIndex.
ReadNode(string, int, OpcAttribute, OpcRange)since v2.24	Reads the range from the attribute of the node specified by nodeId and namespaceIndex.
ReadNode(int, int, OpcRange)since v2.24	Reads the range from the Value attribute of the node specified by nodeId and namespaceIndex.
ReadNode(int, int, OpcAttribute, OpcRange)since v2.24	Reads the range from the attribute of the node specified by nodeId and namespaceIndex.

Known results: BadNodeIdInvalid, BadNodeIdUnknown, BadAttributeInvalid, BadIndexRangeInvalid, BadIndexRangeNoData, BadDataEncodingInvalid, BadDataEncodingUnsupported, BadNotReadable, BadUserAccessDenied

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, BadTooManyOperations, BadMaxAgeInvalid and BadTimestampsToReturnInvalid.

ReadNode(OpcNodeId)

Reads the Value attribute of the node specified by nodeId.

public OpcValue ReadNode(OpcNodeId nodeId)

Public Function ReadNode(nodeId As OpcNodeId) As OpcValue

Parameters

Name	Type	Description
nodeId	OpcNodeId	The OpcNodeId of the node to read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

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 read service is currently not supported, especially using the arguments specified.

ReadNode(OpcNodeId, OpcAttribute)

Reads the attribute of the node specified by nodeId.

public OpcValue ReadNode(OpcNodeId nodeId, OpcAttribute attribute)

Public Function ReadNode(
    nodeId As OpcNodeId,
    attribute As OpcAttribute) As OpcValue

Parameters

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

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

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 read service is currently not supported, especially using the arguments specified.

ReadNode(string)

Reads the Value attribute of the node specified by nodeId.

public OpcValue ReadNode(string nodeId)

Public Function ReadNode(nodeId As String) As OpcValue

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(string, OpcAttribute)

Reads the attribute of the node specified by nodeId.

public OpcValue ReadNode(string nodeId, OpcAttribute attribute)

Public Function ReadNode(
    nodeId As String,
    attribute As OpcAttribute) As OpcValue

Parameters

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

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(int)

Reads the Value attribute of the node specified by nodeId.

public OpcValue ReadNode(int nodeId)

Public Function ReadNode(nodeId As Integer) As OpcValue

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(int, OpcAttribute)

Reads the attribute of the node specified by nodeId.

public OpcValue ReadNode(int nodeId, OpcAttribute attribute)

Public Function ReadNode(
    nodeId As Integer,
    attribute As OpcAttribute) As OpcValue

Parameters

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

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(string, int)

Reads the Value attribute of the node specified by nodeId and namespaceIndex.

public OpcValue ReadNode(string nodeId, int namespaceIndex)

Public Function ReadNode(
    nodeId As String,
    namespaceIndex As Integer) As OpcValue

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to read.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(string, int, OpcAttribute)

Reads the attribute of the node specified by nodeId and namespaceIndex.

public OpcValue ReadNode(
    string nodeId,
    int namespaceIndex,
    OpcAttribute attribute)

Public Function ReadNode(
    nodeId As String,
    namespaceIndex As Integer,
    attribute As OpcAttribute) As OpcValue

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to read.
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.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(int, int)

Reads the Value attribute of the node specified by nodeId and namespaceIndex.

public OpcValue ReadNode(int nodeId, int namespaceIndex)

Public Function ReadNode(
    nodeId As Integer,
    namespaceIndex As Integer) As OpcValue

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to read.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(int, int, OpcAttribute)

Reads the attribute of the node specified by nodeId and namespaceIndex.

public OpcValue ReadNode(int nodeId, int namespaceIndex, OpcAttribute attribute)

Public Function ReadNode(
    nodeId As Integer,
    namespaceIndex As Integer,
    attribute As OpcAttribute) As OpcValue

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to read.
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.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(OpcReadNode)

Reads the value of an attribute of a node using the specified command.

public OpcValue ReadNode(OpcReadNode command)

Public Function ReadNode(command As OpcReadNode) As OpcValue

Parameters

Name	Type	Description
command	OpcReadNode	The OpcReadNode instance to process.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested by the command.

Exceptions

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

ReadNode(OpcNodeId, OpcRange)

since v2.24

Reads the range from the Value attribute of the node specified by nodeId.

public OpcValue ReadNode(OpcNodeId nodeId, OpcRange range)

Public Function ReadNode(nodeId As OpcNodeId, range As OpcRange) As OpcValue

Parameters

Name	Type	Description
nodeId	OpcNodeId	The OpcNodeId of the node to read.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

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 read service is currently not supported, especially using the arguments specified.

ReadNode(OpcNodeId, OpcAttribute, OpcRange)

since v2.24

Reads the range from the attribute of the node specified by nodeId.

public OpcValue ReadNode(
    OpcNodeId nodeId,
    OpcAttribute attribute,
    OpcRange range)

Public Function ReadNode(
    nodeId As OpcNodeId,
    attribute As OpcAttribute,
    range As OpcRange) As OpcValue

Parameters

Name	Type	Description
nodeId	OpcNodeId	The OpcNodeId of the node to read.
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 read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

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 read service is currently not supported, especially using the arguments specified.

ReadNode(string, OpcRange)

since v2.24

Reads the range from the Value attribute of the node specified by nodeId.

public OpcValue ReadNode(string nodeId, OpcRange range)

Public Function ReadNode(nodeId As String, range As OpcRange) As OpcValue

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to read.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(string, OpcAttribute, OpcRange)

since v2.24

Reads the range from the attribute of the node specified by nodeId.

public OpcValue ReadNode(string nodeId, OpcAttribute attribute, OpcRange range)

Public Function ReadNode(
    nodeId As String,
    attribute As OpcAttribute,
    range As OpcRange) As OpcValue

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to read.
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 read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(int, OpcRange)

since v2.24

Reads the range from the Value attribute of the node specified by nodeId.

public OpcValue ReadNode(int nodeId, OpcRange range)

Public Function ReadNode(nodeId As Integer, range As OpcRange) As OpcValue

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to read.
range	OpcRange	The OpcRange to use to identify the single element or range of elements to read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(int, OpcAttribute, OpcRange)

since v2.24

Reads the range from the attribute of the node specified by nodeId.

public OpcValue ReadNode(int nodeId, OpcAttribute attribute, OpcRange range)

Public Function ReadNode(
    nodeId As Integer,
    attribute As OpcAttribute,
    range As OpcRange) As OpcValue

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to read.
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 read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(string, int, OpcRange)

since v2.24

Reads the range from the Value attribute of the node specified by nodeId and namespaceIndex.

public OpcValue ReadNode(string nodeId, int namespaceIndex, OpcRange range)

Public Function ReadNode(
    nodeId As String,
    namespaceIndex As Integer,
    range As OpcRange) As OpcValue

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to read.
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 read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(string, int, OpcAttribute, OpcRange)

since v2.24

Reads the range from the attribute of the node specified by nodeId and namespaceIndex.

public OpcValue ReadNode(
    string nodeId,
    int namespaceIndex,
    OpcAttribute attribute,
    OpcRange range)

Public Function ReadNode(
    nodeId As String,
    namespaceIndex As Integer,
    attribute As OpcAttribute,
    range As OpcRange) As OpcValue

Parameters

Name	Type	Description
nodeId	String	The textual node identifier of the node to read.
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 read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(int, int, OpcRange)

since v2.24

Reads the range from the Value attribute of the node specified by nodeId and namespaceIndex.

public OpcValue ReadNode(int nodeId, int namespaceIndex, OpcRange range)

Public Function ReadNode(
    nodeId As Integer,
    namespaceIndex As Integer,
    range As OpcRange) As OpcValue

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to read.
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 read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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

ReadNode(int, int, OpcAttribute, OpcRange)

since v2.24

Reads the range from the attribute of the node specified by nodeId and namespaceIndex.

public OpcValue ReadNode(
    int nodeId,
    int namespaceIndex,
    OpcAttribute attribute,
    OpcRange range)

Public Function ReadNode(
    nodeId As Integer,
    namespaceIndex As Integer,
    attribute As OpcAttribute,
    range As OpcRange) As OpcValue

Parameters

Name	Type	Description
nodeId	Int32	The numeric node identifier of the node to read.
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 read.

Returns

OpcValue

An instance of the OpcValue class which stores the value requested.

Exceptions

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