Reference

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

24 overloads

Overload	Description
ReadNodeHistory(OpcNodeId, OpcReadHistoryDetails)since v2.23	Reads the historical values of the node identified by the nodeId specified using the details specified to select the values.
ReadNodeHistory(int, OpcNodeId)	Reads the raw historical values of the node identified by the nodeId specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, int, OpcNodeId)	Reads the raw historical values of the node identified by the nodeId specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, int, OpcNodeId)	Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, OpcNodeId)	Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified.
ReadNodeHistory(int, string)	Reads the raw historical values of the node identified by the nodeId specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, int, string)	Reads the raw historical values of the node identified by the nodeId specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, int, string)	Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, string)	Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified.
ReadNodeHistory(int, int)	Reads the raw historical values of the node identified by the nodeId specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, int, int)	Reads the raw historical values of the node identified by the nodeId specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, int, int)	Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, int)	Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified.
ReadNodeHistory(int, string, int)	Reads the raw historical values of the node identified by the nodeId specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, int, string, int)	Reads the raw historical values of the node identified by the nodeId specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, int, string, int)	Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, string, int)	Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified.
ReadNodeHistory(int, int, int)	Reads the raw historical values of the node identified by the nodeId specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, int, int, int)	Reads the raw historical values of the node identified by the nodeId specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, int, int, int)	Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(int, OpcReadNodeHistory)	Reads the raw historical values of the node as defined by the command specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, int, OpcReadNodeHistory)	Reads the raw historical values of the node as defined by the command specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, int, OpcReadNodeHistory)	Reads the raw historical values of the node as defined by the command specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.
ReadNodeHistory(DateTime?, DateTime?, OpcReadNodeHistory)	Reads the raw historical values of the node as defined by the command specified within the period defined by the startTime and endTime specified.

Exceptions (all overloads)

Exception	Condition
OpcException	The client is not connected to the server or the service execution failed upon different circumstances; for more details see exception details.
ObjectDisposedException	The object has been disposed of.

ReadNodeHistory(OpcNodeId, OpcReadHistoryDetails)

since v2.23

Reads the historical values of the node identified by the nodeId specified using the details specified to select the values.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    OpcNodeId nodeId,
    OpcReadHistoryDetails details)

Public Function ReadNodeHistory(
    nodeId As OpcNodeId,
    details As OpcReadHistoryDetails) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
nodeId	OpcNodeId	The OpcNodeId of the node whose history is to be read.
details	OpcReadHistoryDetails	The OpcReadHistoryDetails which define the criteria to use to select the historical values.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null identifier (see IsNull) or the details is an instance of the OpcReadNodeHistoryModifiedDetails class; to read modified values use ReadNodeHistoryModified.
ArgumentNullException	The nodeId or details is a null reference (Nothing in Visual Basic).

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(int, OpcNodeId)

Reads the raw historical values of the node identified by the nodeId specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    int numberOfValues,
    OpcNodeId nodeId)

Public Function ReadNodeHistory(
    numberOfValues As Integer,
    nodeId As OpcNodeId) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
numberOfValues	Int32	The maximum number of values returned for the node per page.
nodeId	OpcNodeId	The OpcNodeId of the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null identifier (see IsNull).
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, int, OpcNodeId)

Reads the raw historical values of the node identified by the nodeId specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    int numberOfValues,
    OpcNodeId nodeId)

Public Function ReadNodeHistory(
    startTime As Date?,
    numberOfValues As Integer,
    nodeId As OpcNodeId) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
nodeId	OpcNodeId	The OpcNodeId of the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null identifier (see IsNull) or the startTime is a null reference (Nothing in Visual Basic) or equals MinValue.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, int, OpcNodeId)

Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    int numberOfValues,
    OpcNodeId nodeId)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    numberOfValues As Integer,
    nodeId As OpcNodeId) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified and the numberOfValues is equals zero the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified and the numberOfValues is equals zero the startTime needs to be specified.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
nodeId	OpcNodeId	The OpcNodeId of the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null identifier (see IsNull) or the startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue and numberOfValues is lower or equals zero.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, OpcNodeId)

Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified.

public IEnumerable<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    OpcNodeId nodeId)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    nodeId As OpcNodeId) As IEnumerable(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified the startTime needs to be specified.
nodeId	OpcNodeId	The OpcNodeId of the node whose history is to be read.

Returns

IEnumerable<OpcHistoryValue>

A sequence of the OpcHistoryValue instances read for the node or an empty sequence if no values have been read for the node.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null identifier (see IsNull) or the startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue.
ArgumentNullException	The nodeId is a null reference (Nothing in Visual Basic).

Remarks

All values within the period are read, also if the server provides them using multiple responses. In case there the server reports a bad status code for the node, an empty sequence is returned instead of throwing an exception.

ReadNodeHistory(int, string)

Reads the raw historical values of the node identified by the nodeId specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    int numberOfValues,
    string nodeId)

Public Function ReadNodeHistory(
    numberOfValues As Integer,
    nodeId As String) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
numberOfValues	Int32	The maximum number of values returned for the node per page.
nodeId	String	The textual node identifier of the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null reference (Nothing in Visual Basic) or equals Empty, which results in a null identifier (see IsNull).
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.
FormatException	The nodeId is not a valid node identifier expression (see Parse) and AlwaysParseStringIdentifiers is false.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, int, string)

Reads the raw historical values of the node identified by the nodeId specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    int numberOfValues,
    string nodeId)

Public Function ReadNodeHistory(
    startTime As Date?,
    numberOfValues As Integer,
    nodeId As String) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
nodeId	String	The textual node identifier of the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null reference (Nothing in Visual Basic) or equals Empty, which results in a null identifier (see IsNull) or the startTime is a null reference (Nothing in Visual Basic) or equals MinValue.
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.
FormatException	The nodeId is not a valid node identifier expression (see Parse) and AlwaysParseStringIdentifiers is false.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, int, string)

Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    int numberOfValues,
    string nodeId)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    numberOfValues As Integer,
    nodeId As String) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified and the numberOfValues is equals zero the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified and the numberOfValues is equals zero the startTime needs to be specified.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
nodeId	String	The textual node identifier of the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null reference (Nothing in Visual Basic) or equals Empty, which results in a null identifier (see IsNull) or the startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue and numberOfValues is lower or equals zero.
FormatException	The nodeId is not a valid node identifier expression (see Parse) and AlwaysParseStringIdentifiers is false.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, string)

Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified.

public IEnumerable<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    string nodeId)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    nodeId As String) As IEnumerable(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified the startTime needs to be specified.
nodeId	String	The textual node identifier of the node whose history is to be read.

Returns

IEnumerable<OpcHistoryValue>

A sequence of the OpcHistoryValue instances read for the node or an empty sequence if no values have been read for the node.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null reference (Nothing in Visual Basic) or equals Empty, which results in a null identifier (see IsNull) or the startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue.
FormatException	The nodeId is not a valid node identifier expression (see Parse) and AlwaysParseStringIdentifiers is false.

Remarks

All values within the period are read, also if the server provides them using multiple responses. In case there the server reports a bad status code for the node, an empty sequence is returned instead of throwing an exception.

ReadNodeHistory(int, int)

Reads the raw historical values of the node identified by the nodeId specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    int numberOfValues,
    int nodeId)

Public Function ReadNodeHistory(
    numberOfValues As Integer,
    nodeId As Integer) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
numberOfValues	Int32	The maximum number of values returned for the node per page.
nodeId	Int32	The numeric node identifier of the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero, which results in a null identifier (see IsNull).
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, int, int)

Reads the raw historical values of the node identified by the nodeId specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    int numberOfValues,
    int nodeId)

Public Function ReadNodeHistory(
    startTime As Date?,
    numberOfValues As Integer,
    nodeId As Integer) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
nodeId	Int32	The numeric node identifier of the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero, which results in a null identifier (see IsNull) or the startTime is a null reference (Nothing in Visual Basic) or equals MinValue.
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, int, int)

Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    int numberOfValues,
    int nodeId)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    numberOfValues As Integer,
    nodeId As Integer) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified and the numberOfValues is equals zero the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified and the numberOfValues is equals zero the startTime needs to be specified.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
nodeId	Int32	The numeric node identifier of the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero, which results in a null identifier (see IsNull) or the startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue and numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, int)

Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified.

public IEnumerable<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    int nodeId)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    nodeId As Integer) As IEnumerable(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified the startTime needs to be specified.
nodeId	Int32	The numeric node identifier of the node whose history is to be read.

Returns

IEnumerable<OpcHistoryValue>

A sequence of the OpcHistoryValue instances read for the node or an empty sequence if no values have been read for the node.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero, which results in a null identifier (see IsNull) or the startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue.

Remarks

All values within the period are read, also if the server provides them using multiple responses. In case there the server reports a bad status code for the node, an empty sequence is returned instead of throwing an exception.

ReadNodeHistory(int, string, int)

Reads the raw historical values of the node identified by the nodeId specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    int numberOfValues,
    string nodeId,
    int namespaceIndex)

Public Function ReadNodeHistory(
    numberOfValues As Integer,
    nodeId As String,
    namespaceIndex As Integer) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
numberOfValues	Int32	The maximum number of values returned for the node per page.
nodeId	String	The textual node identifier of the node whose history is to be read.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null reference (Nothing in Visual Basic) or equals Empty, which results in a null identifier (see IsNull).
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, int, string, int)

Reads the raw historical values of the node identified by the nodeId specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    int numberOfValues,
    string nodeId,
    int namespaceIndex)

Public Function ReadNodeHistory(
    startTime As Date?,
    numberOfValues As Integer,
    nodeId As String,
    namespaceIndex As Integer) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
nodeId	String	The textual node identifier of the node whose history is to be read.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null reference (Nothing in Visual Basic) or equals Empty, which results in a null identifier (see IsNull) or the startTime is a null reference (Nothing in Visual Basic) or equals MinValue.
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, int, string, int)

Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    int numberOfValues,
    string nodeId,
    int namespaceIndex)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    numberOfValues As Integer,
    nodeId As String,
    namespaceIndex As Integer) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified and the numberOfValues is equals zero the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified and the numberOfValues is equals zero the startTime needs to be specified.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
nodeId	String	The textual node identifier of the node whose history is to be read.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null reference (Nothing in Visual Basic) or equals Empty, which results in a null identifier (see IsNull) or the startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue and numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, string, int)

Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified.

public IEnumerable<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    string nodeId,
    int namespaceIndex)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    nodeId As String,
    namespaceIndex As Integer) As IEnumerable(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified the startTime needs to be specified.
nodeId	String	The textual node identifier of the node whose history is to be read.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.

Returns

IEnumerable<OpcHistoryValue>

A sequence of the OpcHistoryValue instances read for the node or an empty sequence if no values have been read for the node.

Exceptions

Exception	Condition
ArgumentException	The nodeId is a null reference (Nothing in Visual Basic) or equals Empty, which results in a null identifier (see IsNull) or the startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue.

Remarks

All values within the period are read, also if the server provides them using multiple responses. In case there the server reports a bad status code for the node, an empty sequence is returned instead of throwing an exception.

ReadNodeHistory(int, int, int)

Reads the raw historical values of the node identified by the nodeId specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    int numberOfValues,
    int nodeId,
    int namespaceIndex)

Public Function ReadNodeHistory(
    numberOfValues As Integer,
    nodeId As Integer,
    namespaceIndex As Integer) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
numberOfValues	Int32	The maximum number of values returned for the node per page.
nodeId	Int32	The numeric node identifier of the node whose history is to be read.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero, which results in a null identifier (see IsNull).
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, int, int, int)

Reads the raw historical values of the node identified by the nodeId specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    int numberOfValues,
    int nodeId,
    int namespaceIndex)

Public Function ReadNodeHistory(
    startTime As Date?,
    numberOfValues As Integer,
    nodeId As Integer,
    namespaceIndex As Integer) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
nodeId	Int32	The numeric node identifier of the node whose history is to be read.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero, which results in a null identifier (see IsNull) or the startTime is a null reference (Nothing in Visual Basic) or equals MinValue.
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, int, int, int)

Reads the raw historical values of the node identified by the nodeId specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    int numberOfValues,
    int nodeId,
    int namespaceIndex)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    numberOfValues As Integer,
    nodeId As Integer,
    namespaceIndex As Integer) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified and the numberOfValues is equals zero the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified and the numberOfValues is equals zero the startTime needs to be specified.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
nodeId	Int32	The numeric node identifier of the node whose history is to be read.
namespaceIndex	Int32	The index of the namespace within that the node with the nodeId specified can be located.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The nodeId is equals zero, which results in a null identifier (see IsNull) or the startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue and numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(int, OpcReadNodeHistory)

Reads the raw historical values of the node as defined by the command specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    int numberOfValues,
    OpcReadNodeHistory command)

Public Function ReadNodeHistory(
    numberOfValues As Integer,
    command As OpcReadNodeHistory) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
numberOfValues	Int32	The maximum number of values returned for the node per page.
command	OpcReadNodeHistory	The OpcReadNodeHistory command which defines the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentNullException	The command is a null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, int, OpcReadNodeHistory)

Reads the raw historical values of the node as defined by the command specified beginning at the startTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    int numberOfValues,
    OpcReadNodeHistory command)

Public Function ReadNodeHistory(
    startTime As Date?,
    numberOfValues As Integer,
    command As OpcReadNodeHistory) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
command	OpcReadNodeHistory	The OpcReadNodeHistory command which defines the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The startTime is a null reference (Nothing in Visual Basic) or equals MinValue.
ArgumentNullException	The command is a null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException	The numberOfValues is lower or equals zero.

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, int, OpcReadNodeHistory)

Reads the raw historical values of the node as defined by the command specified within the period defined by the startTime and endTime specified page by page using the numberOfValues specified as the maximum number of values per page.

public IOpcNodeHistoryNavigator<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    int numberOfValues,
    OpcReadNodeHistory command)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    numberOfValues As Integer,
    command As OpcReadNodeHistory) As IOpcNodeHistoryNavigator(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified and the numberOfValues is equals zero the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified and the numberOfValues is equals zero the startTime needs to be specified.
numberOfValues	Int32	The maximum number of values returned for the node per page. If only one time is specified, the time range shall extend to return this number of values.
command	OpcReadNodeHistory	The OpcReadNodeHistory command which defines the node whose history is to be read.

Returns

IOpcNodeHistoryNavigator<OpcHistoryValue>

An instance implementing the IOpcNodeHistoryNavigator<T> interface which provides the first page of the historical values read for the node and further pages using its MoveNextPage method.

Exceptions

Exception	Condition
ArgumentException	The startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue and numberOfValues is lower or equals zero.
ArgumentNullException	The command is a null reference (Nothing in Visual Basic).

Remarks

In case there the server reports a bad status code for the node, the navigator provides no values instead of throwing an exception.

ReadNodeHistory(DateTime?, DateTime?, OpcReadNodeHistory)

Reads the raw historical values of the node as defined by the command specified within the period defined by the startTime and endTime specified.

public IEnumerable<OpcHistoryValue> ReadNodeHistory(
    DateTime? startTime,
    DateTime? endTime,
    OpcReadNodeHistory command)

Public Function ReadNodeHistory(
    startTime As Date?,
    endTime As Date?,
    command As OpcReadNodeHistory) As IEnumerable(Of OpcHistoryValue)

Parameters

Name	Type	Description
startTime	Nullable<DateTime>	The beginning of the period to read or a null reference (Nothing in Visual Basic) if no specific start time is specified. If startTime is not specified the endTime needs to be specified.
endTime	Nullable<DateTime>	The end of the period to read or a null reference (Nothing in Visual Basic) if no specific end time is specified. If endTime is not specified the startTime needs to be specified.
command	OpcReadNodeHistory	The OpcReadNodeHistory command which defines the node whose history is to be read.

Returns

IEnumerable<OpcHistoryValue>

A sequence of the OpcHistoryValue instances read for the node or an empty sequence if no values have been read for the node.

Exceptions

Exception	Condition
ArgumentException	The startTime and endTime are a null reference (Nothing in Visual Basic) or are equals MinValue.
ArgumentNullException	The command is a null reference (Nothing in Visual Basic).

Remarks

All values within the period are read, also if the server provides them using multiple responses. In case there the server reports a bad status code for the node, an empty sequence is returned instead of throwing an exception.