UA Bundle SDK .NET  2.2.0.255
 All Classes Namespaces Functions Variables Enumerations Enumerator Properties Events Groups Pages
UnifiedAutomation.UaClient.Session Class Reference

A class that manages a session with an OPC UA server. More...

Inherits IDisposable, and UnifiedAutomation.UaBase.IMapperContext.

Public Member Functions

 Session ()
 Create a session for the default client application. More...
 
 Session (ApplicationInstance application)
 Create a session for the specified client application. More...
 
void Dispose ()
 Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. More...
 
void Connect (string endpointUrl, SecuritySelection securitySelection)
 Establish a connection to the OPC UA server. More...
 
void Connect (string endpointUrl, SecuritySelection securitySelection, RequestSettings settings)
 Establish a connection to the OPC UA server. More...
 
void Connect (string endpointUrl, SecuritySelection securitySelection, string transportProfileUri, RetryInitialConnect retryInitialConnect, RequestSettings settings)
 Establish a connection to the OPC UA server. More...
 
IAsyncResult BeginConnect (string endpointUrl, SecuritySelection securitySelection, string transportProfileUri, RetryInitialConnect retryInitialConnect, RequestSettings settings, AsyncCallback callback, object userData)
 Asynchronously establish a connection to the OPC UA server. More...
 
void Connect (EndpointDescription endpoint, RequestSettings settings)
 Establish a connection to the OPC UA server. More...
 
void Connect (EndpointDescription endpoint, RetryInitialConnect retryInitialConnect, RequestSettings settings)
 Establish a connection to the OPC UA server. More...
 
IAsyncResult BeginConnect (EndpointDescription endpoint, RetryInitialConnect retryInitialConnect, RequestSettings settings, AsyncCallback callback, object userData)
 Asynchronously establish a connection to the OPC UA server. More...
 
void EndConnect (IAsyncResult result)
 Completes an asynchronous connect operation. More...
 
void Disconnect ()
 Disconnect client application from OPC UA server. More...
 
void Disconnect (SubscriptionCleanupPolicy cleanupPolicy)
 Disconnect client application from OPC UA server. More...
 
void Disconnect (SubscriptionCleanupPolicy cleanupPolicy, RequestSettings settings)
 Disconnect client application from OPC UA server. More...
 
IAsyncResult BeginDisconnect (AsyncCallback callback, object userData)
 Asynchronously disconnect client application from OPC UA server. More...
 
IAsyncResult BeginDisconnect (SubscriptionCleanupPolicy cleanupPolicy, AsyncCallback callback, object userData)
 Asynchronously disconnect client application from OPC UA server. More...
 
IAsyncResult BeginDisconnect (SubscriptionCleanupPolicy cleanupPolicy, RequestSettings settings, AsyncCallback callback, object userData)
 Asynchronously disconnect client application from OPC UA server. More...
 
void EndDisconnect (IAsyncResult result)
 Completes an asynchronous disconnect operation. More...
 
List< DataValueRead (IList< ReadValueId > nodesToRead, uint maxAge, TimestampsToReturn timestampsToReturn, RequestSettings settings)
 Reads attribute values synchronous from OPC server. More...
 
List< DataValueRead (IList< ReadValueId > nodesToRead)
 Reads attribute values synchronous from OPC server. More...
 
IAsyncResult BeginRead (IList< ReadValueId > nodesToRead, uint maxAge, TimestampsToReturn timestampsToReturn, RequestSettings settings, AsyncCallback callback, object userData)
 Reads values and attributes asynchronously from OPC server. More...
 
IAsyncResult BeginRead (IList< ReadValueId > nodesToRead, uint maxAge, TimestampsToReturn timestampsToReturn, AsyncCallback callback, Object userData)
 This is an overloaded function. See BeginRead for more details. More...
 
IAsyncResult BeginRead (IList< ReadValueId > nodesToRead, uint maxAge, AsyncCallback callback, Object userData)
 This is an overloaded function. See BeginRead for more details. More...
 
List< DataValueEndRead (IAsyncResult result)
 Completes an asynchronous read operation. More...
 
List< StatusCodeWrite (IList< WriteValue > nodesToWrite, RequestSettings settings)
 Writes attributes synchronously to OPC server. More...
 
List< StatusCodeWrite (IList< WriteValue > nodesToWrite)
 Writes attributes synchronously to OPC server. More...
 
IAsyncResult BeginWrite (IList< WriteValue > nodesToWrite, RequestSettings settings, AsyncCallback callback, object userData)
 Writes attributes asynchronously to a OPC UA server. More...
 
IAsyncResult BeginWrite (IList< WriteValue > nodesToWrite, AsyncCallback callback, Object userData)
 This is an overloaded function. See BeginWrite for more details. More...
 
List< StatusCodeEndWrite (IAsyncResult result)
 Ends an asynchronous write operation. More...
 
void ChangeUser ()
 Change user for the connection to the OPC UA server. More...
 
void ChangeUser (UserIdentity userIdentity)
 Change user for the connection to the OPC UA server. More...
 
void ChangeUser (UserIdentity userIdentity, RequestSettings settings)
 Change user for the connection to the OPC UA server. More...
 
IAsyncResult BeginChangeUser (AsyncCallback callback, Object userData)
 Change user for the connection to the OPC UA server asynchronously. More...
 
IAsyncResult BeginChangeUser (UserIdentity userIdentity, RequestSettings settings, AsyncCallback callback, object userData)
 Change user for the connection to the OPC UA server asynchronously. More...
 
void EndChangeUser (IAsyncResult result)
 Completes an asynchronous change user request. More...
 
List< ReferenceDescriptionBrowse (NodeId nodeToBrowse, BrowseContext browseContext, RequestSettings settings, out byte[] continuationPoint)
 Browse OPC server address space with one starting node. More...
 
List< ReferenceDescriptionBrowse (NodeId nodeToBrowse, BrowseContext browseContext, out byte[] continuationPoint)
 This is an overloaded function. See Browse for more details. More...
 
List< ReferenceDescriptionBrowse (NodeId nodeToBrowse, out byte[] continuationPoint)
 This is an overloaded function. See Browse for more details. More...
 
IAsyncResult BeginBrowse (NodeId nodeToBrowse, AsyncCallback callback, Object userData)
 Browse OPC server address space with one starting node asnchonously. More...
 
IAsyncResult BeginBrowse (NodeId nodeToBrowse, BrowseContext browseContext, AsyncCallback callback, Object userData)
 This is an overloaded function. See BeginBrowse for more details. More...
 
IAsyncResult BeginBrowse (NodeId nodeToBrowse, BrowseContext browseContext, RequestSettings settings, AsyncCallback callback, object userData)
 This is an overloaded function. See BeginBrowse for more details. More...
 
List< ReferenceDescriptionEndBrowse (IAsyncResult result, out byte[] continuationPoint)
 Completes an ansynchronous browse operation. More...
 
List< ReferenceDescriptionBrowseNext (ref byte[] continuationPoint)
 Continues a previous Browse request. More...
 
List< ReferenceDescriptionBrowseNext (RequestSettings settings, ref byte[] continuationPoint)
 Continues a previous Browse request. More...
 
IAsyncResult BeginBrowseNext (byte[] continuationPoint, AsyncCallback callback, object userData)
 Continues a previous Browse request asynchronously. More...
 
IAsyncResult BeginBrowseNext (byte[] continuationPoint, RequestSettings settings, AsyncCallback callback, object userData)
 Continues a previous Browse request asynchronously. More...
 
List< List
< ReferenceDescription > > 
BrowseList (List< BrowseDescription > nodesToBrowse)
 Browse OPC server address space with a list of starting nodes. More...
 
List< List
< ReferenceDescription > > 
BrowseList (ViewDescription view, List< BrowseDescription > nodesToBrowse, uint maxReferencesPerBrowse, RequestSettings settings)
 Browse OPC server address space with a list of starting nodes. More...
 
IAsyncResult BeginBrowseList (List< BrowseDescription > nodesToBrowse, AsyncCallback callback, object userData)
 Browse OPC server address space with a list of starting nodes asnchonously. More...
 
IAsyncResult BeginBrowseList (ViewDescription view, List< BrowseDescription > nodesToBrowse, uint maxReferencesPerBrowse, RequestSettings settings, AsyncCallback callback, object userData)
 Browse OPC server address space with a list of starting nodes asnchonously. More...
 
List< List
< ReferenceDescription > > 
EndBrowseList (IAsyncResult result)
 Completes an ansynchronous browse list operation. More...
 
void ReleaseBrowseContinuationPoint (byte[] continuationPoint)
 Releases the browse continuation point. More...
 
void ReleaseBrowseContinuationPoint (byte[] continuationPoint, RequestSettings settings)
 Releases the browse continuation point. More...
 
IAsyncResult BeginReleaseBrowseContinuationPoint (byte[] continuationPoint, AsyncCallback callback, object userData)
 Begins a release browse continuation point operation. More...
 
IAsyncResult BeginReleaseBrowseContinuationPoint (byte[] continuationPoint, RequestSettings settings, AsyncCallback callback, object userData)
 Begins a release browse continuation point operation. More...
 
void EndReleaseBrowseContinuationPoint (IAsyncResult result)
 Ends an asynchronous release browse continuation point operation. More...
 
List< BrowsePathResultTranslateBrowsePath (IList< BrowsePath > pathsToTranslate)
 Translate a browse path to a NodeId. More...
 
List< BrowsePathResultTranslateBrowsePath (IList< BrowsePath > pathsToTranslate, RequestSettings settings)
 Translate a browse path to a NodeId. More...
 
List< BrowsePathResultTranslateBrowsePath (NodeId startingNodeId, IList< string > browsePaths)
 Translates the browse paths. More...
 
List< BrowsePathResultTranslateBrowsePath (NodeId startingNodeId, IList< string > browsePaths, NamespaceTable namespaceUris, RequestSettings settings)
 Translates the browse paths. More...
 
IAsyncResult BeginTranslateBrowsePath (IList< BrowsePath > pathsToTranslate, AsyncCallback callback, object userData)
 Begins a translate browse paths operation. More...
 
IAsyncResult BeginTranslateBrowsePath (NodeId startingNodeId, IList< string > browsePaths, AsyncCallback callback, object userData)
 Begins a translate browse paths operation. More...
 
IAsyncResult BeginTranslateBrowsePath (NodeId startingNodeId, IList< string > browsePaths, NamespaceTable namespaceUris, RequestSettings settings, AsyncCallback callback, object userData)
 Begins a translate browse paths operation. More...
 
IAsyncResult BeginTranslateBrowsePath (IList< BrowsePath > pathsToTranslate, RequestSettings settings, AsyncCallback callback, object userData)
 Begins a translate browse paths operation. More...
 
List< BrowsePathResultEndTranslateBrowsePath (IAsyncResult result)
 Ends an asynchronous translate browse path operation. More...
 
List< VariantCall (NodeId objectToCall, NodeId methodToCall)
 Calls a method of an Object in the OPC server More...
 
StatusCode Call (NodeId objectToCall, NodeId methodToCall, List< Variant > inputArguments, out List< StatusCode > inputArgumentErrors, out List< Variant > outputArguments)
 Calls the specified method. More...
 
StatusCode Call (NodeId objectToCall, NodeId methodToCall, List< Variant > inputArguments, RequestSettings settings, out List< StatusCode > inputArgumentErrors, out List< Variant > outputArguments)
 Calls the specified method. More...
 
IAsyncResult BeginCall (NodeId objectToCall, NodeId methodToCall, List< Variant > inputArguments, RequestSettings settings, AsyncCallback callback, object userData)
 Asynchronously calls the specified method. More...
 
List< VariantEndCall (IAsyncResult result)
 Completes an asynchronous Call operation. More...
 
StatusCode EndCall (IAsyncResult result, out List< StatusCode > inputArgumentErrors, out List< Variant > outputArguments)
 Completes an asynchronous Call operation. More...
 
List< CallMethodResultCallList (IList< CallMethodRequest > methodsToCall, RequestSettings settings)
 Calls the specified methods to call. More...
 
IAsyncResult BeginCallList (IList< CallMethodRequest > methodsToCall, RequestSettings settings, AsyncCallback callback, object userData)
 Asynchronously calls the specified methods. More...
 
List< CallMethodResultEndCallList (IAsyncResult result)
 Completes an asynchronous request to call a list of methods. More...
 
List< HistoryDataReadResultHistoryReadRaw (IList< HistoryReadValueId > nodesToRead, ReadRawModifiedDetails details)
 Reads the history of variable values synchronously from OPC server. More...
 
List< HistoryDataReadResultHistoryReadRaw (IList< HistoryReadValueId > nodesToRead, ReadRawModifiedDetails details, TimestampsToReturn timestampsToReturn, RequestSettings settings)
 Reads the history of variable values synchronously from OPC server. More...
 
IAsyncResult BeginHistoryReadRaw (IList< HistoryReadValueId > nodesToRead, ReadRawModifiedDetails details, AsyncCallback callback, object userData)
 Reads the history of variable values asynchronously from OPC server. More...
 
IAsyncResult BeginHistoryReadRaw (IList< HistoryReadValueId > nodesToRead, ReadRawModifiedDetails details, TimestampsToReturn timestampsToReturn, RequestSettings settings, AsyncCallback callback, object userData)
 Reads the history of variable values asynchronously from OPC server. More...
 
List< HistoryDataReadResultEndHistoryReadRaw (IAsyncResult result)
 Completes an asynchronous HistoryReadRaw operation. More...
 
List< HistoryDataReadResultHistoryReadModified (IList< HistoryReadValueId > nodesToRead, ReadRawModifiedDetails details)
 Reads the history of modified variable values synchronously from the OPC server. More...
 
List< HistoryDataReadResultHistoryReadModified (IList< HistoryReadValueId > nodesToRead, ReadRawModifiedDetails details, TimestampsToReturn timestampsToReturn, RequestSettings settings)
 Reads the history of modified variable values synchronously from the OPC server. More...
 
IAsyncResult BeginHistoryReadModified (IList< HistoryReadValueId > nodesToRead, ReadRawModifiedDetails details, AsyncCallback callback, object userData)
 Reads the history of modified variable values asynchronously from the OPC server. More...
 
IAsyncResult BeginHistoryReadModified (IList< HistoryReadValueId > nodesToRead, ReadRawModifiedDetails details, TimestampsToReturn timestampsToReturn, RequestSettings settings, AsyncCallback callback, object userData)
 Reads the history of modified variable values asynchronously from the OPC server. More...
 
List< HistoryDataReadResultEndHistoryReadModified (IAsyncResult result)
 Completes an asynchronous HistoryReadModified operation. More...
 
List< HistoryDataReadResultHistoryReadProcessed (IList< HistoryReadValueId > nodesToRead, ReadProcessedDetails details)
 Reads the processed history of variable values synchronously from the OPC server based on a passed aggregate. More...
 
List< HistoryDataReadResultHistoryReadProcessed (IList< HistoryReadValueId > nodesToRead, ReadProcessedDetails details, TimestampsToReturn timestampsToReturn, RequestSettings settings)
 Reads the processed history of variable values synchronously from the OPC server based on a passed aggregate. More...
 
IAsyncResult BeginHistoryReadProcessed (IList< HistoryReadValueId > nodesToRead, ReadProcessedDetails details, AsyncCallback callback, object userData)
 Reads the processed history of variable values asynchronously from the OPC server based on a passed aggregate. More...
 
IAsyncResult BeginHistoryReadProcessed (IList< HistoryReadValueId > nodesToRead, ReadProcessedDetails details, TimestampsToReturn timestampsToReturn, RequestSettings settings, AsyncCallback callback, object userData)
 Reads the processed history of variable values asynchronously from the OPC server based on a passed aggregate. More...
 
List< HistoryDataReadResultEndHistoryReadProcessed (IAsyncResult result)
 Completes an asynchronous HistoryReadProcessed operation. More...
 
List< HistoryDataReadResultHistoryReadAtTime (IList< HistoryReadValueId > nodesToRead, ReadAtTimeDetails details)
 Reads the history of item values synchronously from the OPC server for the given timestamps. More...
 
List< HistoryDataReadResultHistoryReadAtTime (IList< HistoryReadValueId > nodesToRead, ReadAtTimeDetails details, TimestampsToReturn timestampsToReturn, RequestSettings settings)
 Reads the history of item values synchronously from the OPC server for the given timestamps. More...
 
IAsyncResult BeginHistoryReadAtTime (IList< HistoryReadValueId > nodesToRead, ReadAtTimeDetails details, AsyncCallback callback, object userData)
 Reads the history of item values asynchronously from the OPC server for the given timestamps. More...
 
IAsyncResult BeginHistoryReadAtTime (IList< HistoryReadValueId > nodesToRead, ReadAtTimeDetails details, TimestampsToReturn timestampsToReturn, RequestSettings settings, AsyncCallback callback, object userData)
 Reads the history of item values asynchronously from the OPC server for the given timestamps. More...
 
List< HistoryDataReadResultEndHistoryReadAtTime (IAsyncResult result)
 Completes an asynchronous HistoryReadAtTime operation. More...
 
List< HistoryDataReadResultReleaseHistoryContinuationPoints (IList< HistoryReadValueId > nodesToRead)
 Releases the history continuation points. More...
 
List< HistoryDataReadResultReleaseHistoryContinuationPoints (IList< HistoryReadValueId > nodesToRead, RequestSettings settings)
 Releases the history continuation points. More...
 
IAsyncResult BeginReleaseHistoryContinuationPoints (IList< HistoryReadValueId > nodesToRead, AsyncCallback callback, object userData)
 Begins a release history continuation point operation. More...
 
IAsyncResult BeginReleaseHistoryContinuationPoints (IList< HistoryReadValueId > nodesToRead, RequestSettings settings, AsyncCallback callback, object userData)
 Begins a release history continuation point operation. More...
 
List< HistoryDataReadResultEndReleaseHistoryContinuationPoints (IAsyncResult result)
 Ends an asynchronous release history continuation point operation. More...
 
List< HistoryDataUpdateResultHistoryUpdateData (IList< UpdateDataDetails > nodesToUpdate)
 Updates the history for a list of variables. More...
 
List< HistoryDataUpdateResultHistoryUpdateData (IList< UpdateDataDetails > nodesToUpdate, RequestSettings settings)
 Updates the history for a list of variables. More...
 
IAsyncResult BeginHistoryUpdateData (IList< UpdateDataDetails > nodesToUpdate, RequestSettings settings, AsyncCallback callback, object userData)
 Begins an operation to update the history for a list of variables. More...
 
List< HistoryDataUpdateResultEndHistoryUpdateData (IAsyncResult result)
 Ends an operation to update the history for a list of variables. More...
 
List< HistoryDataUpdateResultHistoryUpdateStructureData (IList< UpdateStructureDataDetails > nodesToUpdate)
 Updates the history for a list of for structured metadata variables. More...
 
List< HistoryDataUpdateResultHistoryUpdateStructureData (IList< UpdateStructureDataDetails > nodesToUpdate, RequestSettings settings)
 Updates the history for a list of structured metadata variables. More...
 
IAsyncResult BeginHistoryUpdateStructureData (IList< UpdateStructureDataDetails > nodesToUpdate, RequestSettings settings, AsyncCallback callback, object userData)
 Begins an operation to update the history for a list of structured metadata variables. More...
 
List< HistoryDataUpdateResultEndHistoryUpdateStructureData (IAsyncResult result)
 Ends an operation to update the history for a list of structured metadata variables. More...
 
List< HistoryDataUpdateResultHistoryDeleteRaw (IList< DeleteRawModifiedDetails > nodesToDelete)
 Deletes the history for a list of variables in the passed time domain. More...
 
List< HistoryDataUpdateResultHistoryDeleteRaw (IList< DeleteRawModifiedDetails > nodesToDelete, RequestSettings settings)
 Deletes the history for a list of variables in the passed time domain. More...
 
IAsyncResult BeginHistoryDeleteRaw (IList< DeleteRawModifiedDetails > nodesToDelete, RequestSettings settings, AsyncCallback callback, object userData)
 Begins an operation to delete the history for a list of variables in the passed time domain. More...
 
List< HistoryDataUpdateResultEndHistoryDeleteRaw (IAsyncResult result)
 Ends an operation to delete the history for a list of variables. More...
 
List< HistoryDataUpdateResultHistoryDeleteAtTime (IList< DeleteAtTimeDetails > nodesToDelete)
 Deletes the history for a list of variables for the passed timestamps. More...
 
List< HistoryDataUpdateResultHistoryDeleteAtTime (IList< DeleteAtTimeDetails > nodesToDelete, RequestSettings settings)
 Deletes the history for a list of variables for the passed timestamps. More...
 
IAsyncResult BeginHistoryDeleteAtTime (IList< DeleteAtTimeDetails > nodesToDelete, RequestSettings settings, AsyncCallback callback, object userData)
 Begins an operation to delete the history for a list of variables for the passed timestamps. More...
 
List< HistoryDataUpdateResultEndHistoryDeleteAtTime (IAsyncResult result)
 Ends an operation to delete the history for a list of variables. More...
 
List< HistoryEventReadResultHistoryReadEvent (IList< HistoryReadValueId > nodesToRead, ReadEventDetails details)
 Reads the event history for a list of event notifier objects synchronously from an OPC server. More...
 
List< HistoryEventReadResultHistoryReadEvent (IList< HistoryReadValueId > nodesToRead, ReadEventDetails details, RequestSettings settings)
 Reads the event history for a list of event notifier objects synchronously from an OPC server. More...
 
IAsyncResult BeginHistoryReadEvent (IList< HistoryReadValueId > nodesToRead, ReadEventDetails details, AsyncCallback callback, object userData)
 Begins an operation to read the event history for a list of notifiers. More...
 
IAsyncResult BeginHistoryReadEvent (IList< HistoryReadValueId > nodesToRead, ReadEventDetails details, RequestSettings settings, AsyncCallback callback, object userData)
 Begins an operation to read the event history for a list of notifiers. More...
 
List< HistoryEventReadResultEndHistoryReadEvent (IAsyncResult result)
 Ends an operation to read the event history for a list of notifiers. More...
 
List< HistoryEventUpdateResultHistoryUpdateEvent (IList< UpdateEventDetails > nodesToUpdate)
 Updates the event history for a list of event notifier objects. More...
 
List< HistoryEventUpdateResultHistoryUpdateEvent (IList< UpdateEventDetails > nodesToUpdate, RequestSettings settings)
 Updates the event history for a list of event notifier objects. More...
 
IAsyncResult BeginHistoryUpdateEvent (IList< UpdateEventDetails > nodesToUpdate, RequestSettings settings, AsyncCallback callback, object userData)
 Begins an operation to update the history for a list of event notifier objects. More...
 
List< HistoryEventUpdateResultEndHistoryUpdateEvent (IAsyncResult result)
 Ends an operation to update the history for a list of event notifier objects. More...
 
List< HistoryEventUpdateResultHistoryDeleteEvent (IList< DeleteEventDetails > nodesToUpdate)
 Deletes the event history for a list of event notifier objects. More...
 
List< HistoryEventUpdateResultHistoryDeleteEvent (IList< DeleteEventDetails > nodesToUpdate, RequestSettings settings)
 Deletes the event history for a list of event notifier objects. More...
 
IAsyncResult BeginHistoryDeleteEvent (IList< DeleteEventDetails > nodesToUpdate, RequestSettings settings, AsyncCallback callback, object userData)
 Begins an operation to delete the event history for a list of event notifier objects. More...
 
List< HistoryEventUpdateResultEndHistoryDeleteEvent (IAsyncResult result)
 Ends an operation to delete the history for a list of variables. More...
 
List< AddNodesResultAddNodes (IList< AddNodesItem > nodesToAdd, RequestSettings settings)
 Adds the nodes. More...
 
IAsyncResult BeginAddNodes (IList< AddNodesItem > nodesToAdd, RequestSettings settings, AsyncCallback callback, object userData)
 Begins an add nodes operation. More...
 
List< AddNodesResultEndAddNodes (IAsyncResult result)
 Completes an asynchronous add nodes operation. More...
 
List< StatusCodeAddReferences (IList< AddReferencesItem > referencesToAdd, RequestSettings settings)
 Adds the references. More...
 
IAsyncResult BeginAddReferences (IList< AddReferencesItem > referencesToAdd, RequestSettings settings, AsyncCallback callback, object userData)
 Begins the add references operation. More...
 
List< StatusCodeEndAddReferences (IAsyncResult result)
 Ends and asynchronous add references operation. More...
 
List< StatusCodeDeleteNodes (IList< DeleteNodesItem > nodesToDelete, RequestSettings settings)
 Deletes the nodes. More...
 
IAsyncResult BeginDeleteNodes (IList< DeleteNodesItem > nodesToDelete, RequestSettings settings, AsyncCallback callback, object userData)
 Begins the delete nodes operation. More...
 
List< StatusCodeEndDeleteNodes (IAsyncResult result)
 Ends the delete nodes operation. More...
 
List< StatusCodeDeleteReferences (IList< DeleteReferencesItem > referencesToDelete, RequestSettings settings)
 Deletes the references. More...
 
IAsyncResult BeginDeleteReferences (IList< DeleteReferencesItem > referencesToDelete, RequestSettings settings, AsyncCallback callback, object userData)
 Begins the delete references operation. More...
 
List< StatusCodeEndDeleteReferences (IAsyncResult result)
 Ends the delete references operation. More...
 
List< NodeIdRegisterNodes (IList< NodeId > nodesToRegister, RequestSettings settings)
 Registers the nodes. More...
 
IAsyncResult BeginRegisterNodes (IList< NodeId > nodesToRegister, RequestSettings settings, AsyncCallback callback, object userData)
 Begins a register nodes operation. More...
 
List< NodeIdEndRegisterNodes (IAsyncResult result)
 Ends an asynchronous register nodes operation. More...
 
void UnregisterNodes (IList< NodeId > nodesToUnregister, RequestSettings settings)
 Unregisters the nodes. More...
 
IAsyncResult BeginUnregisterNodes (IList< NodeId > nodesToUnregister, RequestSettings settings, AsyncCallback callback, object userData)
 Begins an unregister nodes operation. More...
 
void EndUnregisterNodes (IAsyncResult result)
 Ends an asynchronous unregister nodes operation. More...
 

Properties

ApplicationInstance Application [get, set]
 Gets the application. More...
 
NodeId SessionId [get]
 Gets the session id. More...
 
CacheManager Cache [get, set]
 Gets the cache manager. More...
 
ModelManager Model [get, set]
 Gets the model manager. More...
 
Object UserData [get, set]
 Gets or sets the user data. More...
 
RequestSettings DefaultRequestSettings [get, set]
 Gets or sets the default settings used as fallback for OPC UA service calls. More...
 
string SessionName [get, set]
 Gets or sets the name of the session. More...
 
UserIdentity UserIdentity [get, set]
 Gets or sets the user identity. More...
 
IList< string > PreferredLocales [get, set]
 Gets or sets the preferred locales. More...
 
int SecureChannelLifetime [get, set]
 Gets or sets the secure channel lifetime. More...
 
int SecureChannelTimeout [get, set]
 Gets or sets the secure channel timeout. More...
 
int SessionTimeout [get, set]
 Gets or sets the session timeout. More...
 
uint WatchdogCycleTime [get, set]
 Gets or sets the watchdog cycle time. More...
 
uint WatchdogTimeout [get, set]
 Gets or sets the watchdog timeout. More...
 
bool AutomaticReconnect [get, set]
 Gets or sets a value indicating whether the session should automatically reconnect on error. More...
 
uint ReconnectDelay [get, set]
 Gets or sets the delay between reconnect attempts. More...
 
uint PublishPipelineDepth [get, set]
 Gets or sets the publish pipeline depth. More...
 
bool UseDnsNameAndPortFromDiscoveryUrl [get, set]
 Gets or sets a value indicating whether to use DNS name and port from discovery URL when connecting to a server. More...
 
EndpointDescription EndpointDescription [get, set]
 Gets or sets the endpoint description. More...
 
ServerConnectionStatus ConnectionStatus [get, set]
 Gets the server connection status. More...
 
IList< string > AlternativeEndpointUrls [get, set]
 Gets or sets the alternative endpoint urls. More...
 
TimestampsToReturn DefaultTimestampToReturn [get, set]
 Gets or sets the default timestamp to return. More...
 
MessageContext MessageContext [get]
 Gets the message context. More...
 
NamespaceTable NamespaceUris [get]
 Gets the namespace uris. More...
 
StringTable ServerUris [get]
 Gets the server uris. More...
 
EncodeableFactory Factory [get]
 Gets the dictionary of data types known to the stack. More...
 

Events

ServerConnectionStatusUpdateEventHandler ConnectionStatusUpdate
 Raised when the connection status has been updated. More...
 
SessionValidationEventHandler SessionValidationError
 Raised when a non-fatal error occurs during session establishment. More...
 
UpdateEndpointEventHandler UpdateEndpoint
 Raised before connecting to the server and it allows the application to modify the endpoint used to connect. More...
 

Detailed Description

A class that manages a session with an OPC UA server.

Constructor & Destructor Documentation

UnifiedAutomation.UaClient.Session.Session ( )
inline

Create a session for the default client application.

UnifiedAutomation.UaClient.Session.Session ( ApplicationInstance  application)
inline

Create a session for the specified client application.

Member Function Documentation

List<AddNodesResult> UnifiedAutomation.UaClient.Session.AddNodes ( IList< AddNodesItem nodesToAdd,
RequestSettings  settings 
)
inline

Adds the nodes.

Parameters
nodesToAddThe nodes to add.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
List<StatusCode> UnifiedAutomation.UaClient.Session.AddReferences ( IList< AddReferencesItem referencesToAdd,
RequestSettings  settings 
)
inline

Adds the references.

Parameters
referencesToAddThe references to add.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
IAsyncResult UnifiedAutomation.UaClient.Session.BeginAddNodes ( IList< AddNodesItem nodesToAdd,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins an add nodes operation.

Parameters
nodesToAddThe nodes to add.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndAddNodes method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginAddReferences ( IList< AddReferencesItem referencesToAdd,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins the add references operation.

Parameters
referencesToAddThe references to add.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndAddReferences() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginBrowse ( NodeId  nodeToBrowse,
AsyncCallback  callback,
Object  userData 
)
inline

Browse OPC server address space with one starting node asnchonously.

The Browse Service is used by a client to navigate through the Address Space by passing a starting Node and browse filters. The server returns the list of referenced nodes matching the filter criteria.

The Browse Service takes a list of starting Nodes and returns a list of connected Nodes for each starting Node. Nevertheless, most clients will only pass one starting Node for the main purpose of building a tree hierarchy. Since the OPC UA Address Space can be a full-meshed network and is not limited to a pure hierarchy, the capability to pass in a list of starting Nodes is mainly used to browse metadata like the Properties of a list of Variables. The client SDK provides different browse methods, one for a single starting Node and one for a list of starting Nodes.

This simplified browse method is used for a single starting node.

Parameters
nodeToBrowseThe node to browse.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.

This method returns only forward hierarchial references.

Returns
An object which must be passed to the EndBrowse method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginBrowse ( NodeId  nodeToBrowse,
BrowseContext  browseContext,
AsyncCallback  callback,
Object  userData 
)
inline

This is an overloaded function. See BeginBrowse for more details.

Parameters
nodeToBrowseThe node to browse.
browseContextThe browse context.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndBrowse method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginBrowse ( NodeId  nodeToBrowse,
BrowseContext  browseContext,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

This is an overloaded function. See BeginBrowse for more details.

Parameters
nodeToBrowseThe node to browse.
browseContextThe browse context.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndBrowse method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginBrowseList ( List< BrowseDescription nodesToBrowse,
AsyncCallback  callback,
object  userData 
)
inline

Browse OPC server address space with a list of starting nodes asnchonously.

The Browse Service is used by a client to navigate through the Address Space by passing a starting Node and browse filters. The server returns the list of referenced nodes matching the filter criteria.

The Browse Service takes a list of starting Nodes and returns a list of connected Nodes for each starting Node. Nevertheless, most clients will only pass one starting Node for the main purpose of building a tree hierarchy. Since the OPC UA Address Space can be a full-meshed network and is not limited to a pure hierarchy, the capability to pass in a list of starting Nodes is mainly used to browse metadata like the Properties of a list of Variables. The client SDK provides different browse methods, one for a single starting Node and one for a list of starting Nodes.

This browse method is used for a list of starting nodes.

Parameters
nodesToBrowseThe nodes to browse.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndBrowseList method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginBrowseList ( ViewDescription  view,
List< BrowseDescription nodesToBrowse,
uint  maxReferencesPerBrowse,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Browse OPC server address space with a list of starting nodes asnchonously.

The Browse Service is used by a client to navigate through the Address Space by passing a starting Node and browse filters. The server returns the list of referenced nodes matching the filter criteria.

The Browse Service takes a list of starting Nodes and returns a list of connected Nodes for each starting Node. Nevertheless, most clients will only pass one starting Node for the main purpose of building a tree hierarchy. Since the OPC UA Address Space can be a full-meshed network and is not limited to a pure hierarchy, the capability to pass in a list of starting Nodes is mainly used to browse metadata like the Properties of a list of Variables. The client SDK provides different browse methods, one for a single starting Node and one for a list of starting Nodes.

This browse method is used for a list of starting nodes.

Parameters
viewThe view.
nodesToBrowseThe nodes to browse.
maxReferencesPerBrowseThe maximum number of references per browse.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndBrowseList method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginBrowseNext ( byte[]  continuationPoint,
AsyncCallback  callback,
object  userData 
)
inline

Continues a previous Browse request asynchronously.

This method is only used to continue a browse started with the browse method if not all results could be returned by the browse or a following browseNext call. The number of Nodes to return can be limited by the client in the browse request or by the Server during processing the Browse Service call.

Parameters
continuationPointContinuation points returned from a previous browse or browseNext call. A continuation point is returned when the server was not able to deliver all results in the BrowseNext response. The limitation can be set by the client in the browse or by the server during processing the Browse Service call.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndBrowse method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginBrowseNext ( byte[]  continuationPoint,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Continues a previous Browse request asynchronously.

This method is only used to continue a browse started with the browse method if not all results could be returned by the browse or a following browseNext call. The number of Nodes to return can be limited by the client in the browse request or by the Server during processing the Browse Service call.

Parameters
continuationPointContinuation points returned from a previous browse or browseNext call. A continuation point is returned when the server was not able to deliver all results in the BrowseNext response. The limitation can be set by the client in the browse or by the server during processing the Browse Service call.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndBrowse method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginCall ( NodeId  objectToCall,
NodeId  methodToCall,
List< Variant inputArguments,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Asynchronously calls the specified method.

Parameters
objectToCallThe object to call.
methodToCallThe method to call.
inputArgumentsThe input arguments.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndCall method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginCallList ( IList< CallMethodRequest methodsToCall,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Asynchronously calls the specified methods.

Parameters
methodsToCallThe methods to call.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndCallList method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginChangeUser ( AsyncCallback  callback,
Object  userData 
)
inline

Change user for the connection to the OPC UA server asynchronously.

Parameters
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndChangeUser method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginChangeUser ( UserIdentity  userIdentity,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Change user for the connection to the OPC UA server asynchronously.

Parameters
userIdentityThe user identity.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndChangeUser method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginConnect ( string  endpointUrl,
SecuritySelection  securitySelection,
string  transportProfileUri,
RetryInitialConnect  retryInitialConnect,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Asynchronously establish a connection to the OPC UA server.

Calling this function successfully creates a secure channel to the server endpoint and it creates and activates an application session in the server application.

The SDK is managing the connection to the server by

  • Monitoring the status of the session with read calls to the server status variable. The frequency of the read calls can be controlled with the property WatchdogCycleTime
  • Reconnect on TCP/IP or SecureChannel level if the connection was lost
  • Recreation of the session if the session timed out or the server was restarted
  • The callback ConnectionStatusUpdate provides information about the current status of the session
Parameters
endpointUrlThe URL of the server endpoint to connect to.
UA TCP: opc.tcp://networknode:4840
WebService: https://networknode/ServerName
securitySelectionThe requested security level. The option None disables security. The option BestAvailable selects the highest security level suported by the server.
transportProfileUriThe transport profile URI to use (if null the default for the URL scheme is used).
retryInitialConnectWhether to retry a failed connect in the background.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndConnect() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginConnect ( EndpointDescription  endpoint,
RetryInitialConnect  retryInitialConnect,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Asynchronously establish a connection to the OPC UA server.

Connects to the specified endpoint provided by a server or stored in configuration. The available endpoints can be requested through Discovery.GetEndpoints

Parameters
endpointThe full definition of an OPC UA server endpoint.
retryInitialConnectWhether to retry a failed connect in the background.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndConnect() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginDeleteNodes ( IList< DeleteNodesItem nodesToDelete,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins the delete nodes operation.

Parameters
nodesToDeleteThe nodes to delete.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndDeleteNodes() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginDeleteReferences ( IList< DeleteReferencesItem referencesToDelete,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins the delete references operation.

Parameters
referencesToDeleteThe references to delete.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndDeleteReferences() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginDisconnect ( AsyncCallback  callback,
object  userData 
)
inline

Asynchronously disconnect client application from OPC UA server.

Calling this function closes the session and the secure channel connection to the server. The subscriptions assigned to the session are also deleted.

Parameters
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndDisconnect() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginDisconnect ( SubscriptionCleanupPolicy  cleanupPolicy,
AsyncCallback  callback,
object  userData 
)
inline

Asynchronously disconnect client application from OPC UA server.

Calling this function closes the session and the secure channel connection to the server. The subscriptions assigned the session are also deleted if the cleanupPolicy is set to Delete.

Parameters
cleanupPolicyThe cleanup policy for the subscription. The option Delete removes the subscription together with the session. The subscriptions are not deleted when option Keep is used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndDisconnect() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginDisconnect ( SubscriptionCleanupPolicy  cleanupPolicy,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Asynchronously disconnect client application from OPC UA server.

Calling this function closes the session and the secure channel connection to the server. The subscriptions assigned the session are also deleted if the cleanupPolicy is set to Delete.

Parameters
cleanupPolicyThe cleanup policy for the subscription. The option Delete removes the subscription together with the session. The subscriptions are not deleted when option Keep is used.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndDisconnect() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryDeleteAtTime ( IList< DeleteAtTimeDetails nodesToDelete,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins an operation to delete the history for a list of variables for the passed timestamps.

Parameters
nodesToDeleteThe variables with history to delete, including the timestamps for the data to be deleted.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryDeleteAtTime() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryDeleteEvent ( IList< DeleteEventDetails nodesToUpdate,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins an operation to delete the event history for a list of event notifier objects.

Parameters
nodesToUpdateList of event notifier objects and Ids of events to delete.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryDeleteEvent() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryDeleteRaw ( IList< DeleteRawModifiedDetails nodesToDelete,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins an operation to delete the history for a list of variables in the passed time domain.

Parameters
nodesToDeleteThe variables with history to delete, including the time domain for the data to be deleted.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryDeleteRaw() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryReadAtTime ( IList< HistoryReadValueId nodesToRead,
ReadAtTimeDetails  details,
AsyncCallback  callback,
object  userData 
)
inline

Reads the history of item values asynchronously from the OPC server for the given timestamps.

Parameters
nodesToReadList of variable nodes to read data values at specified timestamps from.
detailsConfiguration parameters for the history read of data at specified timestamps. Configuration parameters include
  • Array of timestamps for which values are to be read
  • Flag for bounding value calculation
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryReadAtTime() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryReadAtTime ( IList< HistoryReadValueId nodesToRead,
ReadAtTimeDetails  details,
TimestampsToReturn  timestampsToReturn,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Reads the history of item values asynchronously from the OPC server for the given timestamps.

Parameters
nodesToReadList of variable nodes to read data values at specified timestamps from.
detailsConfiguration parameters for the history read of data at specified timestamps. Configuration parameters include
  • Array of timestamps for which values are to be read
  • Flag for bounding value calculation
timestampsToReturnEnumeration for the timestamps to return with the values. Possible values are source, server or both. The option neither is invalid for history read.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryReadAtTime() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryReadEvent ( IList< HistoryReadValueId nodesToRead,
ReadEventDetails  details,
AsyncCallback  callback,
object  userData 
)
inline

Begins an operation to read the event history for a list of notifiers.

Parameters
nodesToReadList of event notifier object nodes to read event history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of events. Configuration parameters include
  • the start time of the requested time domain,
  • the end time of the requested time domain,
  • the event filter,
  • a limitation of the number of results per node.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryReadEvent() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryReadEvent ( IList< HistoryReadValueId nodesToRead,
ReadEventDetails  details,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins an operation to read the event history for a list of notifiers.

Parameters
nodesToReadList of event notifier object nodes to read event history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of events. Configuration parameters include
  • the start time of the requested time domain,
  • the end time of the requested time domain,
  • the event filter,
  • a limitation of the number of results per node.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryReadEvent() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryReadModified ( IList< HistoryReadValueId nodesToRead,
ReadRawModifiedDetails  details,
AsyncCallback  callback,
object  userData 
)
inline

Reads the history of modified variable values asynchronously from the OPC server.

This method is used to read modified historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read. The returned number can be limited by the client or the server. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

Parameters
nodesToReadList of variable nodes to read modified data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of modified data. Configuration parameters include
  • The start time of the requested time interval
  • The end time of the requested time interval
  • Setting if bounding values should be returned
  • Limitation of the number of results per node
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryReadModified() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryReadModified ( IList< HistoryReadValueId nodesToRead,
ReadRawModifiedDetails  details,
TimestampsToReturn  timestampsToReturn,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Reads the history of modified variable values asynchronously from the OPC server.

This method is used to read modified historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read. The returned number can be limited by the client or the server. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

Parameters
nodesToReadList of variable nodes to read modified data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of modified data. Configuration parameters include
  • The start time of the requested time interval
  • The end time of the requested time interval
  • Setting if bounding values should be returned
  • Limitation of the number of results per node
timestampsToReturnEnumeration for the timestamps to return with the values. Possible values are source, server or both. The option neither is invalid for history read.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryReadModified() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryReadProcessed ( IList< HistoryReadValueId nodesToRead,
ReadProcessedDetails  details,
AsyncCallback  callback,
object  userData 
)
inline

Reads the processed history of variable values asynchronously from the OPC server based on a passed aggregate.

This method is used to read processed historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read or if the server was not able to finish the processing before the timeout expired. The returned number can be limited by the server and may be 0 if the server was not able to finish one calculation before the service timeout expired. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

The processed values are calculated with the specified aggregate based on the raw data in the history database. The server must use start time, end time, and the resample interval to generate a sequence of time intervals and then calculate an aggregate for each interval.

Parameters
nodesToReadList of variable nodes to read processed data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of processed data. Configuration parameters include
  • The start time of the requested time domain
  • The end time of the requested time domain
  • Time processing interval used to calculate one aggregated value from the raw values
  • The NodeId of the aggregate used for the calculation of the values
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryReadProcessed() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryReadProcessed ( IList< HistoryReadValueId nodesToRead,
ReadProcessedDetails  details,
TimestampsToReturn  timestampsToReturn,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Reads the processed history of variable values asynchronously from the OPC server based on a passed aggregate.

This method is used to read processed historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read or if the server was not able to finish the processing before the timeout expired. The returned number can be limited by the server and may be 0 if the server was not able to finish one calculation before the service timeout expired. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

The processed values are calculated with the specified aggregate based on the raw data in the history database. The server must use start time, end time, and the resample interval to generate a sequence of time intervals and then calculate an aggregate for each interval.

Parameters
nodesToReadList of variable nodes to read processed data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of processed data. Configuration parameters include
  • The start time of the requested time domain
  • The end time of the requested time domain
  • Time processing interval used to calculate one aggregated value from the raw values
  • The NodeId of the aggregate used for the calculation of the values
timestampsToReturnThe timestamps to return.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryReadProcessed() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryReadRaw ( IList< HistoryReadValueId nodesToRead,
ReadRawModifiedDetails  details,
AsyncCallback  callback,
object  userData 
)
inline

Reads the history of variable values asynchronously from OPC server.

This method is used to read raw historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read. The returned number can be limited by the client or the server. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

Parameters
nodesToReadList of variable nodes to read data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of raw data. Configuration parameters include
  • The start time of the requested time interval
  • The end time of the requested time interval
  • Setting if bounding values should be returned
  • Limitation of the number of results per node
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryReadRaw() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryReadRaw ( IList< HistoryReadValueId nodesToRead,
ReadRawModifiedDetails  details,
TimestampsToReturn  timestampsToReturn,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Reads the history of variable values asynchronously from OPC server.

This method is used to read raw historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read. The returned number can be limited by the client or the server. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

Parameters
nodesToReadList of variable nodes to read data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of raw data. Configuration parameters include
  • The start time of the requested time interval
  • The end time of the requested time interval
  • Setting if bounding values should be returned
  • Limitation of the number of results per node
timestampsToReturnEnumeration for the timestamps to return with the values. Possible values are source, server or both. The option neither is invalid for history read.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryReadRaw() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryUpdateData ( IList< UpdateDataDetails nodesToUpdate,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins an operation to update the history for a list of variables.

Parameters
nodesToUpdateThe list of variable nodes to update, including the data provided for the update.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryUpdateData() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryUpdateEvent ( IList< UpdateEventDetails nodesToUpdate,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins an operation to update the history for a list of event notifier objects.

Parameters
nodesToUpdateList of event notifier objects to update, including the event data and update settings.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryUpdateEvent() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginHistoryUpdateStructureData ( IList< UpdateStructureDataDetails nodesToUpdate,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins an operation to update the history for a list of structured metadata variables.

Parameters
nodesToUpdateThe list of variable nodes to update, including the data provided for the update.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndHistoryUpdateStructureData() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginRead ( IList< ReadValueId nodesToRead,
uint  maxAge,
TimestampsToReturn  timestampsToReturn,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Reads values and attributes asynchronously from OPC server.

The Read Service is used to read one or more attributes of one or more nodes. It allows also reading subsets or single elements of array values and to define a valid age of values to be returned to reduce the need for device reads. Like most other services, the read is optimized for bulk read operations and not for reading single Attribute values. Typically all Node Attributes are readable. For the Value Attribute the Read rights are indicated by the AccessLevel and UserAccessLevel Attribute of the Variable.

Parameters
nodesToReadList of nodes and attributes to read.
maxAgeThe maximum age for any value.
timestampsToReturnOPC UA defines two timestamps, the source and the server timestamp. This parameter allows the client to define which timestamps the server should return with the value.
The source timestamp is only available for Value Attributes. The source timestamp is used to reflect the timestamp that was applied to a Variable value by the data source. It should indicate the last change of the value or status code. The source timestamp must be always generated by the same physical clock. This timestamp type was added for OPC UA to cover the use case to get the timestamp of the last value change which is different than the server timestamp definition.
The server timestamp is used to reflect the time that the server received a Variable value or knew it to be accurate if the changes are reported by exception and the connection to the data source is operating. This is the behavior expected by Classic OPC
Possible values are
  • TimestampsToReturn.Source
  • TimestampsToReturn.Server
  • TimestampsToReturn.Both
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndRead() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginRead ( IList< ReadValueId nodesToRead,
uint  maxAge,
TimestampsToReturn  timestampsToReturn,
AsyncCallback  callback,
Object  userData 
)
inline

This is an overloaded function. See BeginRead for more details.

Parameters
nodesToReadThe nodes to read.
maxAgeThe max age.
timestampsToReturnThe timestamps to return.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndRead() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginRead ( IList< ReadValueId nodesToRead,
uint  maxAge,
AsyncCallback  callback,
Object  userData 
)
inline

This is an overloaded function. See BeginRead for more details.

Parameters
nodesToReadThe nodes to read.
maxAgeThe max age.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndRead() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginRegisterNodes ( IList< NodeId nodesToRegister,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins a register nodes operation.

Parameters
nodesToRegisterThe nodes to register.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndRegisterNodes() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginReleaseBrowseContinuationPoint ( byte[]  continuationPoint,
AsyncCallback  callback,
object  userData 
)
inline

Begins a release browse continuation point operation.

Parameters
continuationPointThe continuation point.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndReleaseBrowseContinuationPoint method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginReleaseBrowseContinuationPoint ( byte[]  continuationPoint,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins a release browse continuation point operation.

Parameters
continuationPointThe continuation point.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndReleaseBrowseContinuationPoint method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginReleaseHistoryContinuationPoints ( IList< HistoryReadValueId nodesToRead,
AsyncCallback  callback,
object  userData 
)
inline

Begins a release history continuation point operation.

Parameters
nodesToReadThe nodes to read.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndReleaseHistoryContinuationPoints method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginReleaseHistoryContinuationPoints ( IList< HistoryReadValueId nodesToRead,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins a release history continuation point operation.

Parameters
nodesToReadThe nodes to read.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndReleaseHistoryContinuationPoints method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginTranslateBrowsePath ( IList< BrowsePath pathsToTranslate,
AsyncCallback  callback,
object  userData 
)
inline

Begins a translate browse paths operation.

Parameters
pathsToTranslateThe paths to translate.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndTranslateBrowsePath method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginTranslateBrowsePath ( NodeId  startingNodeId,
IList< string >  browsePaths,
AsyncCallback  callback,
object  userData 
)
inline

Begins a translate browse paths operation.

Parameters
startingNodeIdThe starting node.
browsePathsA list of browse paths to translate.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndTranslateBrowsePath method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginTranslateBrowsePath ( NodeId  startingNodeId,
IList< string >  browsePaths,
NamespaceTable  namespaceUris,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins a translate browse paths operation.

Parameters
startingNodeIdThe starting node.
browsePathsA list of browse paths to translate.
namespaceUrisThe table of namespace referenced by the browse paths (if null the session namespace table is assumed).
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndTranslateBrowsePath method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginTranslateBrowsePath ( IList< BrowsePath pathsToTranslate,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins a translate browse paths operation.

Parameters
pathsToTranslateThe paths to translate.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndTranslateBrowsePath method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginUnregisterNodes ( IList< NodeId nodesToUnregister,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Begins an unregister nodes operation.

Parameters
nodesToUnregisterThe nodes to unregister.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndUnregisterNodes() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginWrite ( IList< WriteValue nodesToWrite,
RequestSettings  settings,
AsyncCallback  callback,
object  userData 
)
inline

Writes attributes asynchronously to a OPC UA server.

The Write Service is used to write one or more attributes of one or more nodes. For the Value Attribute the Write rights are indicated by the AccessLevel and UserAccessLevel Attribute of the Variable.

Parameters
nodesToWriteList of nodes and attributes to write.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
callbackThe callback to use when the async call completes.
userDataThe user data that is passed to the callback.
Returns
An object which must be passed to the EndWrite() method.
IAsyncResult UnifiedAutomation.UaClient.Session.BeginWrite ( IList< WriteValue nodesToWrite,
AsyncCallback  callback,
Object  userData 
)
inline

This is an overloaded function. See BeginWrite for more details.

List<ReferenceDescription> UnifiedAutomation.UaClient.Session.Browse ( NodeId  nodeToBrowse,
BrowseContext  browseContext,
RequestSettings  settings,
out byte[]  continuationPoint 
)
inline

Browse OPC server address space with one starting node.

The Browse Service is used by a client to navigate through the Address Space by passing a starting Node and browse filters. The server returns the list of referenced nodes matching the filter criteria.

The Browse Service takes a list of starting Nodes and returns a list of connected Nodes for each starting Node. Nevertheless, most clients will only pass one starting Node for the main purpose of building a tree hierarchy. Since the OPC UA Address Space can be a full-meshed network and is not limited to a pure hierarchy, the capability to pass in a list of starting Nodes is mainly used to browse metadata like the Properties of a list of Variables. The client SDK provides different browse methods, one for a single starting Node and one for a list of starting Nodes.

This simplified browse method is used for a single starting node.

Parameters
nodeToBrowseNodeId of the starting Node
browseContextFilter settings for the browse call. See BrowseContext for more details.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
continuationPointout: A continuation point is returned when the server was not able to deliver all results in the Browse response. The limitation can be set by the client in the request or by the server during Browse processing. The continuation point can be passed to browseNext to get the remaining results.
Returns
List of references and target Node information for the Nodes passing the filter criteria set in the request.
List<ReferenceDescription> UnifiedAutomation.UaClient.Session.Browse ( NodeId  nodeToBrowse,
BrowseContext  browseContext,
out byte[]  continuationPoint 
)
inline

This is an overloaded function. See Browse for more details.

Parameters
nodeToBrowseThe node to browse.
browseContextThe browse context.
continuationPointThe continuation point.
Returns
List<ReferenceDescription> UnifiedAutomation.UaClient.Session.Browse ( NodeId  nodeToBrowse,
out byte[]  continuationPoint 
)
inline

This is an overloaded function. See Browse for more details.

Parameters
nodeToBrowseThe node to browse.
continuationPointThe continuation point.

This method returns only forward hierarchial references.

Returns
List<List<ReferenceDescription> > UnifiedAutomation.UaClient.Session.BrowseList ( List< BrowseDescription nodesToBrowse)
inline

Browse OPC server address space with a list of starting nodes.

The Browse Service is used by a client to navigate through the Address Space by passing a starting Node and browse filters. The server returns the list of referenced nodes matching the filter criteria.

The Browse Service takes a list of starting Nodes and returns a list of connected Nodes for each starting Node. Nevertheless, most clients will only pass one starting Node for the main purpose of building a tree hierarchy. Since the OPC UA Address Space can be a full-meshed network and is not limited to a pure hierarchy, the capability to pass in a list of starting Nodes is mainly used to browse metadata like the Properties of a list of Variables. The client SDK provides different browse methods, one for a single starting Node and one for a list of starting Nodes.

This browse method is used for a list of starting nodes.

Parameters
nodesToBrowseThe nodes to browse.
Returns
List of references and target Node information for the Nodes passing the filter criteria set in the request.
List<List<ReferenceDescription> > UnifiedAutomation.UaClient.Session.BrowseList ( ViewDescription  view,
List< BrowseDescription nodesToBrowse,
uint  maxReferencesPerBrowse,
RequestSettings  settings 
)
inline

Browse OPC server address space with a list of starting nodes.

The Browse Service is used by a client to navigate through the Address Space by passing a starting Node and browse filters. The server returns the list of referenced nodes matching the filter criteria.

The Browse Service takes a list of starting Nodes and returns a list of connected Nodes for each starting Node. Nevertheless, most clients will only pass one starting Node for the main purpose of building a tree hierarchy. Since the OPC UA Address Space can be a full-meshed network and is not limited to a pure hierarchy, the capability to pass in a list of starting Nodes is mainly used to browse metadata like the Properties of a list of Variables. The client SDK provides different browse methods, one for a single starting Node and one for a list of starting Nodes.

This browse method is used for a list of starting nodes.

Parameters
viewThe view.
nodesToBrowseThe nodes to browse.
maxReferencesPerBrowseThe maximum number of references per browse.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
List of references and target Node information for the Nodes passing the filter criteria set in the request.
List<ReferenceDescription> UnifiedAutomation.UaClient.Session.BrowseNext ( ref byte[]  continuationPoint)
inline

Continues a previous Browse request.

This method is only used to continue a browse started with the browse method if not all results could be returned by the browse or a following browseNext call. The number of Nodes to return can be limited by the client in the browse request or by the Server during processing the Browse Service call.

Parameters
continuationPointContinuation points returned from a previous browse or browseNext call. A continuation point is returned when the server was not able to deliver all results in the BrowseNext response. The limitation can be set by the client in the browse or by the server during processing the Browse Service call.
Returns
List of references and target Node information for the Nodes passing the filter criteria set in the request.
List<ReferenceDescription> UnifiedAutomation.UaClient.Session.BrowseNext ( RequestSettings  settings,
ref byte[]  continuationPoint 
)
inline

Continues a previous Browse request.

This method is only used to continue a browse started with the browse method if not all results could be returned by the browse or a following browseNext call. The number of Nodes to return can be limited by the client in the browse request or by the Server during processing the Browse Service call.

Parameters
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
continuationPointContinuation points returned from a previous browse or browseNext call. A continuation point is returned when the server was not able to deliver all results in the BrowseNext response. The limitation can be set by the client in the browse or by the server during processing the Browse Service call.
Returns
List of references and target Node information for the Nodes passing the filter criteria set in the first browse call
List<Variant> UnifiedAutomation.UaClient.Session.Call ( NodeId  objectToCall,
NodeId  methodToCall 
)
inline

Calls a method of an Object in the OPC server

Parameters
objectToCallThe object to call.
methodToCallThe method to call.
Returns
StatusCode UnifiedAutomation.UaClient.Session.Call ( NodeId  objectToCall,
NodeId  methodToCall,
List< Variant inputArguments,
out List< StatusCode inputArgumentErrors,
out List< Variant outputArguments 
)
inline

Calls the specified method.

Parameters
objectToCallThe object to call.
methodToCallThe method to call.
inputArgumentsThe input arguments.
inputArgumentErrorsThe input argument errors.
outputArgumentsThe output arguments.
Returns
StatusCode UnifiedAutomation.UaClient.Session.Call ( NodeId  objectToCall,
NodeId  methodToCall,
List< Variant inputArguments,
RequestSettings  settings,
out List< StatusCode inputArgumentErrors,
out List< Variant outputArguments 
)
inline

Calls the specified method.

Parameters
objectToCallThe object to call.
methodToCallThe method to call.
inputArgumentsThe input arguments.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
inputArgumentErrorsThe input argument errors.
outputArgumentsThe output arguments.
Returns
List<CallMethodResult> UnifiedAutomation.UaClient.Session.CallList ( IList< CallMethodRequest methodsToCall,
RequestSettings  settings 
)
inline

Calls the specified methods to call.

Parameters
methodsToCallThe methods to call.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
void UnifiedAutomation.UaClient.Session.ChangeUser ( )
inline

Change user for the connection to the OPC UA server.

Calling this function changes the user of the session by calling ActivateSession with the new user identity.

void UnifiedAutomation.UaClient.Session.ChangeUser ( UserIdentity  userIdentity)
inline

Change user for the connection to the OPC UA server.

Calling this function changes the user of the session by calling ActivateSession with the new user identity.

Parameters
userIdentityThe user identity.
void UnifiedAutomation.UaClient.Session.ChangeUser ( UserIdentity  userIdentity,
RequestSettings  settings 
)
inline

Change user for the connection to the OPC UA server.

Calling this function changes the user of the session by calling ActivateSession with the new user identity.

Parameters
userIdentityThe user identity.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
void UnifiedAutomation.UaClient.Session.Connect ( string  endpointUrl,
SecuritySelection  securitySelection 
)
inline

Establish a connection to the OPC UA server.

Calling this function successfully creates a secure channel to the server endpoint and it creates and activates an application session in the server application.

The SDK is managing the connection to the server by

  • Monitoring the status of the session with read calls to the server status variable. The frequency of the read calls can be controlled with the property WatchdogCycleTime
  • Reconnect on TCP/IP or SecureChannel level if the connection was lost
  • Recreation of the session if the session timed out or the server was restarted
  • The callback ConnectionStatusUpdate provides information about the current status of the session
Parameters
endpointUrlThe URL of the server endpoint to connect to.
UA TCP: opc.tcp://networknode:4840
WebService: https://networknode/ServerName
securitySelectionThe requested security level. The option None disables security. The option BestAvailable selects the highest security level suported by the server.
void UnifiedAutomation.UaClient.Session.Connect ( string  endpointUrl,
SecuritySelection  securitySelection,
RequestSettings  settings 
)
inline

Establish a connection to the OPC UA server.

Calling this function successfully creates a secure channel to the server endpoint and it creates and activates an application session in the server application.

The SDK is managing the connection to the server by

  • Monitoring the status of the session with read calls to the server status variable. The frequency of the read calls can be controlled with the property WatchdogCycleTime
  • Reconnect on TCP/IP or SecureChannel level if the connection was lost
  • Recreation of the session if the session timed out or the server was restarted
  • The callback ConnectionStatusUpdate provides information about the current status of the session
Parameters
endpointUrlThe URL of the server endpoint to connect to.
UA TCP: opc.tcp://networknode:4840
WebService: https://networknode/ServerName
securitySelectionThe requested security level. The option None disables security. The option BestAvailable selects the highest security level suported by the server.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
void UnifiedAutomation.UaClient.Session.Connect ( string  endpointUrl,
SecuritySelection  securitySelection,
string  transportProfileUri,
RetryInitialConnect  retryInitialConnect,
RequestSettings  settings 
)
inline

Establish a connection to the OPC UA server.

Calling this function successfully creates a secure channel to the server endpoint and it creates and activates an application session in the server application.

The SDK is managing the connection to the server by

  • Monitoring the status of the session with read calls to the server status variable. The frequency of the read calls can be controlled with the property WatchdogCycleTime
  • Reconnect on TCP/IP or SecureChannel level if the connection was lost
  • Recreation of the session if the session timed out or the server was restarted
  • The callback ConnectionStatusUpdate provides information about the current status of the session
Parameters
endpointUrlThe URL of the server endpoint to connect to.
UA TCP: opc.tcp://networknode:4840
WebService: https://networknode/ServerName
securitySelectionThe requested security level. The option None disables security. The option BestAvailable selects the highest security level suported by the server.
transportProfileUriThe transport profile URI to use (if null the default for the URL scheme is used).
retryInitialConnectWhether to retry a failed connect in the background.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
void UnifiedAutomation.UaClient.Session.Connect ( EndpointDescription  endpoint,
RequestSettings  settings 
)
inline

Establish a connection to the OPC UA server.

Connects to the specified endpoint provided by a server or stored in configuration. The available endpoints can be requested through Discovery.GetEndpoints.

Parameters
endpointThe full definition of an OPC UA server endpoint.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
void UnifiedAutomation.UaClient.Session.Connect ( EndpointDescription  endpoint,
RetryInitialConnect  retryInitialConnect,
RequestSettings  settings 
)
inline

Establish a connection to the OPC UA server.

Connects to the specified endpoint provided by a server or stored in configuration. The available endpoints can be requested through Discovery.GetEndpoints.

Parameters
endpointThe full definition of an OPC UA server endpoint.
retryInitialConnectWhether to retry a failed connect in the background.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
List<StatusCode> UnifiedAutomation.UaClient.Session.DeleteNodes ( IList< DeleteNodesItem nodesToDelete,
RequestSettings  settings 
)
inline

Deletes the nodes.

Parameters
nodesToDeleteThe nodes to delete.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
List<StatusCode> UnifiedAutomation.UaClient.Session.DeleteReferences ( IList< DeleteReferencesItem referencesToDelete,
RequestSettings  settings 
)
inline

Deletes the references.

Parameters
referencesToDeleteThe references to delete.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
void UnifiedAutomation.UaClient.Session.Disconnect ( )
inline

Disconnect client application from OPC UA server.

Calling this function closes the session and the secure channel connection to the server. The subscriptions assigned to the session are also deleted.

void UnifiedAutomation.UaClient.Session.Disconnect ( SubscriptionCleanupPolicy  cleanupPolicy)
inline

Disconnect client application from OPC UA server.

Calling this function closes the session and the secure channel connection to the server. The subscriptions assigned the session are also deleted if the cleanupPolicy is set to Delete.

Parameters
cleanupPolicyThe cleanup policy for the subscription. The option Delete removes the subscription together with the session. The subscriptions are not deleted when option Keep is used.
void UnifiedAutomation.UaClient.Session.Disconnect ( SubscriptionCleanupPolicy  cleanupPolicy,
RequestSettings  settings 
)
inline

Disconnect client application from OPC UA server.

Calling this function closes the session and the secure channel connection to the server. The subscriptions assigned the session are also deleted if the cleanupPolicy is set to Delete.

Parameters
cleanupPolicyThe cleanup policy for the subscription. The option Delete removes the subscription together with the session. The subscriptions are not deleted when option Keep is used.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
void UnifiedAutomation.UaClient.Session.Dispose ( )
inline

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

List<AddNodesResult> UnifiedAutomation.UaClient.Session.EndAddNodes ( IAsyncResult  result)
inline

Completes an asynchronous add nodes operation.

Parameters
resultThe object returned from the BeginAddNodes method.
Returns
List<StatusCode> UnifiedAutomation.UaClient.Session.EndAddReferences ( IAsyncResult  result)
inline

Ends and asynchronous add references operation.

Parameters
resultThe object returned from the BeginAddReferences() method.
Returns
List<ReferenceDescription> UnifiedAutomation.UaClient.Session.EndBrowse ( IAsyncResult  result,
out byte[]  continuationPoint 
)
inline

Completes an ansynchronous browse operation.

Parameters
resultThe object returned from the BeginBrowse method.
continuationPointThe continuation point.
Returns
List of references and target Node information for the Nodes passing the filter criteria set in the request.
List<List<ReferenceDescription> > UnifiedAutomation.UaClient.Session.EndBrowseList ( IAsyncResult  result)
inline

Completes an ansynchronous browse list operation.

Parameters
resultThe object returned from the BeginBrowseList method.
Returns
List of references and target Node information for the Nodes passing the filter criteria set in the request.
List<Variant> UnifiedAutomation.UaClient.Session.EndCall ( IAsyncResult  result)
inline

Completes an asynchronous Call operation.

Parameters
resultThe object returned from the BeginCall method.
Returns
StatusCode UnifiedAutomation.UaClient.Session.EndCall ( IAsyncResult  result,
out List< StatusCode inputArgumentErrors,
out List< Variant outputArguments 
)
inline

Completes an asynchronous Call operation.

Parameters
resultThe object returned from the BeginCall method.
inputArgumentErrorsThe input argument errors.
outputArgumentsThe output arguments.
Returns
List<CallMethodResult> UnifiedAutomation.UaClient.Session.EndCallList ( IAsyncResult  result)
inline

Completes an asynchronous request to call a list of methods.

Parameters
resultThe object returned from the BeginCallList method.
Returns
void UnifiedAutomation.UaClient.Session.EndChangeUser ( IAsyncResult  result)
inline

Completes an asynchronous change user request.

Parameters
resultThe result returned from BeginChangeUser method
void UnifiedAutomation.UaClient.Session.EndConnect ( IAsyncResult  result)
inline

Completes an asynchronous connect operation.

Parameters
resultThe object returned from the BeginConnect() method.
List<StatusCode> UnifiedAutomation.UaClient.Session.EndDeleteNodes ( IAsyncResult  result)
inline

Ends the delete nodes operation.

Parameters
resultThe object returned from the BeginDeleteNodes() method.
Returns
List<StatusCode> UnifiedAutomation.UaClient.Session.EndDeleteReferences ( IAsyncResult  result)
inline

Ends the delete references operation.

Parameters
resultThe object returned from the BeginDeleteReferences() method.
Returns
void UnifiedAutomation.UaClient.Session.EndDisconnect ( IAsyncResult  result)
inline

Completes an asynchronous disconnect operation.

Parameters
resultThe object returned from the BeginDisconnect method.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.EndHistoryDeleteAtTime ( IAsyncResult  result)
inline

Ends an operation to delete the history for a list of variables.

Parameters
resultThe object returned from the BeginHistoryDeleteAtTime method.
Returns
The results for the delete operation.
List<HistoryEventUpdateResult> UnifiedAutomation.UaClient.Session.EndHistoryDeleteEvent ( IAsyncResult  result)
inline

Ends an operation to delete the history for a list of variables.

Parameters
resultThe object returned from the BeginHistoryDeleteEvent method.
Returns
The results for the delete operation.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.EndHistoryDeleteRaw ( IAsyncResult  result)
inline

Ends an operation to delete the history for a list of variables.

Parameters
resultThe object returned from the BeginHistoryDeleteRaw method.
Returns
The results for the delete operation.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.EndHistoryReadAtTime ( IAsyncResult  result)
inline

Completes an asynchronous HistoryReadAtTime operation.

Parameters
resultThe object returned from the BeginHistoryReadAtTime method.
Returns
Result data for the requested nodes and time stamps.
List<HistoryEventReadResult> UnifiedAutomation.UaClient.Session.EndHistoryReadEvent ( IAsyncResult  result)
inline

Ends an operation to read the event history for a list of notifiers.

Parameters
resultThe object returned from the BeginHistoryReadEvent method.
Returns
The event history for each notifier.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.EndHistoryReadModified ( IAsyncResult  result)
inline

Completes an asynchronous HistoryReadModified operation.

Parameters
resultThe object returned from the BeginHistoryReadModified method.
Returns
Result data for the requested nodes and time interval. A continuation point is included for a node if not all results could be returned.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.EndHistoryReadProcessed ( IAsyncResult  result)
inline

Completes an asynchronous HistoryReadProcessed operation.

Parameters
resultThe object returned from the BeginHistoryReadProcessed method.
Returns
Result data for the requested nodes, time domain and aggregates. A continuation point is included for a node if not all results could be returned or processed before the timeout expired.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.EndHistoryReadRaw ( IAsyncResult  result)
inline

Completes an asynchronous HistoryReadRaw operation.

Parameters
resultThe object returned from the BeginHistoryReadRaw method.
Returns
Result data for the requested nodes and time interval. A continuation point is included for a node if not all results could be returned.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.EndHistoryUpdateData ( IAsyncResult  result)
inline

Ends an operation to update the history for a list of variables.

Parameters
resultThe object returned from the BeginHistoryUpdateData method.
Returns
The results for the update operation.
List<HistoryEventUpdateResult> UnifiedAutomation.UaClient.Session.EndHistoryUpdateEvent ( IAsyncResult  result)
inline

Ends an operation to update the history for a list of event notifier objects.

Parameters
resultThe object returned from the BeginHistoryUpdateEvent method.
Returns
The results for the update operation.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.EndHistoryUpdateStructureData ( IAsyncResult  result)
inline

Ends an operation to update the history for a list of structured metadata variables.

Parameters
resultThe object returned from the BeginHistoryUpdateStructureData method.
Returns
The results for the update operation.
List<DataValue> UnifiedAutomation.UaClient.Session.EndRead ( IAsyncResult  result)
inline

Completes an asynchronous read operation.

Parameters
resultThe object returned from the BeginRead method.
Returns
List of read results.
List<NodeId> UnifiedAutomation.UaClient.Session.EndRegisterNodes ( IAsyncResult  result)
inline

Ends an asynchronous register nodes operation.

Parameters
resultThe object returned from the BeginRegisterNodes() method.
Returns
void UnifiedAutomation.UaClient.Session.EndReleaseBrowseContinuationPoint ( IAsyncResult  result)
inline

Ends an asynchronous release browse continuation point operation.

Parameters
resultThe object returned from the BeginReleaseBrowseContinuationPoint method.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.EndReleaseHistoryContinuationPoints ( IAsyncResult  result)
inline

Ends an asynchronous release history continuation point operation.

Parameters
resultThe object returned from the BeginReleaseHistoryContinuationPoints method.
Returns
List<BrowsePathResult> UnifiedAutomation.UaClient.Session.EndTranslateBrowsePath ( IAsyncResult  result)
inline

Ends an asynchronous translate browse path operation.

Parameters
resultThe object returned from the BeginTranslateBrowsePath method.
Returns
void UnifiedAutomation.UaClient.Session.EndUnregisterNodes ( IAsyncResult  result)
inline

Ends an asynchronous unregister nodes operation.

Parameters
resultThe object returned from the BeginUnregisterNodes() method.
Returns
List<StatusCode> UnifiedAutomation.UaClient.Session.EndWrite ( IAsyncResult  result)
inline

Ends an asynchronous write operation.

Parameters
resultThe result returned from BeginWrite method.
Returns
A list of StatusCodes that indicates for each node if the write operation has been successful.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.HistoryDeleteAtTime ( IList< DeleteAtTimeDetails nodesToDelete)
inline

Deletes the history for a list of variables for the passed timestamps.

Parameters
nodesToDeleteThe variables with history to delete, including the timestamps for the data to be deleted.
Returns
The results for the delete operation.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.HistoryDeleteAtTime ( IList< DeleteAtTimeDetails nodesToDelete,
RequestSettings  settings 
)
inline

Deletes the history for a list of variables for the passed timestamps.

Parameters
nodesToDeleteThe variables with history to delete, including the timestamps for the data to be deleted.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
The results for the delete operation.
List<HistoryEventUpdateResult> UnifiedAutomation.UaClient.Session.HistoryDeleteEvent ( IList< DeleteEventDetails nodesToUpdate)
inline

Deletes the event history for a list of event notifier objects.

Parameters
nodesToUpdateList of event notifier objects and Ids of events to delete.
Returns
The results for the delete operation.
List<HistoryEventUpdateResult> UnifiedAutomation.UaClient.Session.HistoryDeleteEvent ( IList< DeleteEventDetails nodesToUpdate,
RequestSettings  settings 
)
inline

Deletes the event history for a list of event notifier objects.

Parameters
nodesToUpdateList of event notifier objects and Ids of events to delete.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
The results for the delete operation.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.HistoryDeleteRaw ( IList< DeleteRawModifiedDetails nodesToDelete)
inline

Deletes the history for a list of variables in the passed time domain.

Parameters
nodesToDeleteThe variables with history to delete, including the time domain for the data to be deleted.
Returns
The results for the delete operation.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.HistoryDeleteRaw ( IList< DeleteRawModifiedDetails nodesToDelete,
RequestSettings  settings 
)
inline

Deletes the history for a list of variables in the passed time domain.

Parameters
nodesToDeleteThe variables with history to delete, including the time domain for the data to be deleted.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
The results for the delete operation.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.HistoryReadAtTime ( IList< HistoryReadValueId nodesToRead,
ReadAtTimeDetails  details 
)
inline

Reads the history of item values synchronously from the OPC server for the given timestamps.

Parameters
nodesToReadList of variable nodes to read data values at specified timestamps from.
detailsConfiguration parameters for the history read of data at specified timestamps. Configuration parameters include
  • Array of timestamps for which values are to be read
  • Flag for bounding value calculation
Returns
Result data for the requested nodes and time stamps.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.HistoryReadAtTime ( IList< HistoryReadValueId nodesToRead,
ReadAtTimeDetails  details,
TimestampsToReturn  timestampsToReturn,
RequestSettings  settings 
)
inline

Reads the history of item values synchronously from the OPC server for the given timestamps.

Parameters
nodesToReadList of variable nodes to read data values at specified timestamps from.
detailsConfiguration parameters for the history read of data at specified timestamps. Configuration parameters include
  • Array of timestamps for which values are to be read
  • Flag for bounding value calculation
timestampsToReturnEnumeration for the timestamps to return with the values. Possible values are source, server or both. The option neither is invalid for history read.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
Result data for the requested nodes and time stamps.
List<HistoryEventReadResult> UnifiedAutomation.UaClient.Session.HistoryReadEvent ( IList< HistoryReadValueId nodesToRead,
ReadEventDetails  details 
)
inline

Reads the event history for a list of event notifier objects synchronously from an OPC server.

Parameters
nodesToReadList of event notifier object nodes to read event history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of events. Configuration parameters include,
  • the start time of the requested time domain,
  • the end time of the requested time domain,
  • the event filter,
  • a limitation of the number of results per node.
Returns
The event history for each notifier.
List<HistoryEventReadResult> UnifiedAutomation.UaClient.Session.HistoryReadEvent ( IList< HistoryReadValueId nodesToRead,
ReadEventDetails  details,
RequestSettings  settings 
)
inline

Reads the event history for a list of event notifier objects synchronously from an OPC server.

Parameters
nodesToReadList of event notifier object nodes to read event history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of events. Configuration parameters include
  • the start time of the requested time domain,
  • the end time of the requested time domain,
  • the event filter,
  • a limitation of the number of results per node.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
The event history for each notifier.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.HistoryReadModified ( IList< HistoryReadValueId nodesToRead,
ReadRawModifiedDetails  details 
)
inline

Reads the history of modified variable values synchronously from the OPC server.

This method is used to read modified historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read. The returned number can be limited by the client or the server. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

Parameters
nodesToReadList of variable nodes to read modified data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of modified data. Configuration parameters include
  • The start time of the requested time interval
  • The end time of the requested time interval
  • Setting if bounding values should be returned
  • Limitation of the number of results per node
Returns
Result data for the requested nodes and time interval. A continuation point is included for a node if not all results could be returned.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.HistoryReadModified ( IList< HistoryReadValueId nodesToRead,
ReadRawModifiedDetails  details,
TimestampsToReturn  timestampsToReturn,
RequestSettings  settings 
)
inline

Reads the history of modified variable values synchronously from the OPC server.

This method is used to read modified historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read. The returned number can be limited by the client or the server. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

Parameters
nodesToReadList of variable nodes to read modified data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of modified data. Configuration parameters include
  • The start time of the requested time interval
  • The end time of the requested time interval
  • Setting if bounding values should be returned
  • Limitation of the number of results per node
timestampsToReturnEnumeration for the timestamps to return with the values. Possible values are source, server or both. The option neither is invalid for history read.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
Result data for the requested nodes and time interval. A continuation point is included for a node if not all results could be returned.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.HistoryReadProcessed ( IList< HistoryReadValueId nodesToRead,
ReadProcessedDetails  details 
)
inline

Reads the processed history of variable values synchronously from the OPC server based on a passed aggregate.

This method is used to read processed historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read or if the server was not able to finish the processing before the timeout expired. The returned number can be limited by the server and may be 0 if the server was not able to finish one calculation before the service timeout expired. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

The processed values are calculated with the specified aggregate based on the raw data in the history database. The server must use start time, end time, and the resample interval to generate a sequence of time intervals and then calculate an aggregate for each interval.

Parameters
nodesToReadList of variable nodes to read processed data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of processed data. Configuration parameters include
  • The start time of the requested time domain
  • The end time of the requested time domain
  • Time processing interval used to calculate one aggregated value from the raw values
  • The NodeId of the aggregate used for the calculation of the values
Returns
Result data for the requested nodes, time domain and aggregates. A continuation point is included for a node if not all results could be returned or processed before the timeout expired.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.HistoryReadProcessed ( IList< HistoryReadValueId nodesToRead,
ReadProcessedDetails  details,
TimestampsToReturn  timestampsToReturn,
RequestSettings  settings 
)
inline

Reads the processed history of variable values synchronously from the OPC server based on a passed aggregate.

This method is used to read processed historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read or if the server was not able to finish the processing before the timeout expired. The returned number can be limited by the server and may be 0 if the server was not able to finish one calculation before the service timeout expired. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

The processed values are calculated with the specified aggregate based on the raw data in the history database. The server must use start time, end time, and the resample interval to generate a sequence of time intervals and then calculate an aggregate for each interval.

Parameters
nodesToReadList of variable nodes to read processed data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of processed data. Configuration parameters include
  • The start time of the requested time domain
  • The end time of the requested time domain
  • Time processing interval used to calculate one aggregated value from the raw values
  • The NodeId of the aggregate used for the calculation of the values
timestampsToReturnThe timestamps to return.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
Result data for the requested nodes, time domain and aggregates. A continuation point is included for a node if not all results could be returned or processed before the timeout expired.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.HistoryReadRaw ( IList< HistoryReadValueId nodesToRead,
ReadRawModifiedDetails  details 
)
inline

Reads the history of variable values synchronously from OPC server.

This method is used to read raw historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read. The returned number can be limited by the client or the server. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

Parameters
nodesToReadList of variable nodes to read data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of raw data. Configuration parameters include
  • The start time of the requested time interval
  • The end time of the requested time interval
  • Setting if bounding values should be returned
  • Limitation of the number of results per node
Returns
Result data for the requested nodes and time interval. A continuation point is included for a node if not all results could be returned.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.HistoryReadRaw ( IList< HistoryReadValueId nodesToRead,
ReadRawModifiedDetails  details,
TimestampsToReturn  timestampsToReturn,
RequestSettings  settings 
)
inline

Reads the history of variable values synchronously from OPC server.

This method is used to read raw historical values of one or more nodes in an ordered sequence for the defined time domain. Continuation points are used to continue the read of the ordered sequence if not all data can be returned in one read. The returned number can be limited by the client or the server. See ReleaseHistoryContinuationPoints for cleaning up resources in the server if read should not be continued with the returned continuation point.

Parameters
nodesToReadList of variable nodes to read data history from. Includes a continuation point to continue previous read requests.
detailsConfiguration parameters for the history read of raw data. Configuration parameters include
  • The start time of the requested time interval
  • The end time of the requested time interval
  • Setting if bounding values should be returned
  • Limitation of the number of results per node
timestampsToReturnEnumeration for the timestamps to return with the values. Possible values are source, server or both. The option neither is invalid for history read.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
Result data for the requested nodes and time interval. A continuation point is included for a node if not all results could be returned.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.HistoryUpdateData ( IList< UpdateDataDetails nodesToUpdate)
inline

Updates the history for a list of variables.

Parameters
nodesToUpdateThe list of variable nodes to update, including the data provided for the update.
Returns
The results for the update operation.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.HistoryUpdateData ( IList< UpdateDataDetails nodesToUpdate,
RequestSettings  settings 
)
inline

Updates the history for a list of variables.

Parameters
nodesToUpdateThe list of variable nodes to update, including the data provided for the update.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
The results for the update operation.
List<HistoryEventUpdateResult> UnifiedAutomation.UaClient.Session.HistoryUpdateEvent ( IList< UpdateEventDetails nodesToUpdate)
inline

Updates the event history for a list of event notifier objects.

Parameters
nodesToUpdateList of event notifier objects to update, including the event data and update settings.
Returns
The results for the update operation.
List<HistoryEventUpdateResult> UnifiedAutomation.UaClient.Session.HistoryUpdateEvent ( IList< UpdateEventDetails nodesToUpdate,
RequestSettings  settings 
)
inline

Updates the event history for a list of event notifier objects.

Parameters
nodesToUpdateList of event notifier objects to update, including the event data and update settings.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
The results for the update operation.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.HistoryUpdateStructureData ( IList< UpdateStructureDataDetails nodesToUpdate)
inline

Updates the history for a list of for structured metadata variables.

Parameters
nodesToUpdateThe list of variable nodes to update, including the data provided for the update.
Returns
The results for the update operation.
List<HistoryDataUpdateResult> UnifiedAutomation.UaClient.Session.HistoryUpdateStructureData ( IList< UpdateStructureDataDetails nodesToUpdate,
RequestSettings  settings 
)
inline

Updates the history for a list of structured metadata variables.

Parameters
nodesToUpdateThe list of variable nodes to update, including the data provided for the update.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
The results for the update operation.
List<DataValue> UnifiedAutomation.UaClient.Session.Read ( IList< ReadValueId nodesToRead,
uint  maxAge,
TimestampsToReturn  timestampsToReturn,
RequestSettings  settings 
)
inline

Reads attribute values synchronous from OPC server.

The Read Service is used to read one or more attributes of one or more nodes. It allows also reading subsets or single elements of array values and to define a valid age of values to be returned to reduce the need for device reads. Like most other services, the read is optimized for bulk read operations and not for reading single Attribute values. Typically, all Node Attributes are readable. For the Value Attribute, the Read rights are indicated by the AccessLevel and UserAccessLevel Attribute of the Variable.

Parameters
nodesToReadList of nodes and attributes to read.
maxAgeThe maximum age of the value to be read in milliseconds.
This parameter allows clients to reduce the communication between server and data source by allowing the server to return a cached value that is not older than the defined time period. Setting a value of 0 forces the server to obtain the current value. This is similar to a device read in Classic OPC.
timestampsToReturnOPC UA defines two timestamps, the source and the server timestamp. This parameter allows the client to define which timestamps the server should return with the value.
The source timestamp is only available for Value Attributes. The source timestamp is used to reflect the timestamp that was applied to a Variable value by the data source. It should indicate the last change of the value or status code. The source timestamp must be always generated by the same physical clock. This timestamp type was added for OPC UA to cover the use case to get the timestamp of the last value change which is different than the server timestamp definition.
The server timestamp is used to reflect the time that the server received a Variable value or knew it to be accurate if the changes are reported by exception and the connection to the data source is operating. This is the behavior expected by Classic OPC
Possible values are
  • TimestampsToReturn.Source
  • TimestampsToReturn.Server
  • TimestampsToReturn.Both
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
List of read results.
List<DataValue> UnifiedAutomation.UaClient.Session.Read ( IList< ReadValueId nodesToRead)
inline

Reads attribute values synchronous from OPC server.

The Read Service is used to read one or more attributes of one or more nodes. It allows also reading subsets or single elements of array values and to define a valid age of values to be returned to reduce the need for device reads. Like most other services, the read is optimized for bulk read operations and not for reading single Attribute values. Typically, all Node Attributes are readable. For the Value Attribute, the Read rights are indicated by the AccessLevel and UserAccessLevel Attribute of the Variable.

Parameters
nodesToReadList of nodes and attributes to read.
Returns
List of read results.
List<NodeId> UnifiedAutomation.UaClient.Session.RegisterNodes ( IList< NodeId nodesToRegister,
RequestSettings  settings 
)
inline

Registers the nodes.

Parameters
nodesToRegisterThe nodes to register.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
void UnifiedAutomation.UaClient.Session.ReleaseBrowseContinuationPoint ( byte[]  continuationPoint)
inline

Releases the browse continuation point.

Parameters
continuationPointThe continuation point.
void UnifiedAutomation.UaClient.Session.ReleaseBrowseContinuationPoint ( byte[]  continuationPoint,
RequestSettings  settings 
)
inline

Releases the browse continuation point.

Parameters
continuationPointThe continuation point.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.ReleaseHistoryContinuationPoints ( IList< HistoryReadValueId nodesToRead)
inline

Releases the history continuation points.

Parameters
nodesToReadThe nodes to read.
Returns
List<HistoryDataReadResult> UnifiedAutomation.UaClient.Session.ReleaseHistoryContinuationPoints ( IList< HistoryReadValueId nodesToRead,
RequestSettings  settings 
)
inline

Releases the history continuation points.

Parameters
nodesToReadThe nodes to read.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
List<BrowsePathResult> UnifiedAutomation.UaClient.Session.TranslateBrowsePath ( IList< BrowsePath pathsToTranslate)
inline

Translate a browse path to a NodeId.

This Service is used to access components of an Object based on the knowledge about the ObjectType. Since the NodeId of a Node is needed to access information provided by the Node like subscribing for Variable Value changes or to call a Method, it is necessary to know the NodeIds of components of Objects. Since OPC UA allows programming software components with built-in knowledge of ObjectTypes, UA needs to provide a mechanism to return the NodeIds for components of an Object instance based on the knowledge about the ObjectType. This mechanism is built on the requirement that the BrowseNames of components in the instance must be the same like BrowseNames of components in the type.

Parameters
pathsToTranslateThe list of browse paths for which NodeIds are requested
Returns
List<BrowsePathResult> UnifiedAutomation.UaClient.Session.TranslateBrowsePath ( IList< BrowsePath pathsToTranslate,
RequestSettings  settings 
)
inline

Translate a browse path to a NodeId.

This Service is used to access components of an Object based on the knowledge about the ObjectType. Since the NodeId of a Node is needed to access information provided by the Node like subscribing for Variable Value changes or to call a Method, it is necessary to know the NodeIds of components of Objects. Since OPC UA allows programming software components with built-in knowledge of ObjectTypes, UA needs to provide a mechanism to return the NodeIds for components of an Object instance based on the knowledge about the ObjectType. This mechanism is built on the requirement that the BrowseNames of components in the instance must be the same like BrowseNames of components in the type.

Parameters
pathsToTranslateThe list of browse paths for which NodeIds are requested
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
List<BrowsePathResult> UnifiedAutomation.UaClient.Session.TranslateBrowsePath ( NodeId  startingNodeId,
IList< string >  browsePaths 
)
inline

Translates the browse paths.

Parameters
startingNodeIdThe starting node.
browsePathsA list of browse paths to translate.
Returns
List<BrowsePathResult> UnifiedAutomation.UaClient.Session.TranslateBrowsePath ( NodeId  startingNodeId,
IList< string >  browsePaths,
NamespaceTable  namespaceUris,
RequestSettings  settings 
)
inline

Translates the browse paths.

Parameters
startingNodeIdThe starting node.
browsePathsA list of browse paths to translate.
namespaceUrisThe table of namespaces referenced by the browse paths (if null the session namespace table is assumed).
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
void UnifiedAutomation.UaClient.Session.UnregisterNodes ( IList< NodeId nodesToUnregister,
RequestSettings  settings 
)
inline

Unregisters the nodes.

Parameters
nodesToUnregisterThe nodes to unregister.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
List<StatusCode> UnifiedAutomation.UaClient.Session.Write ( IList< WriteValue nodesToWrite,
RequestSettings  settings 
)
inline

Writes attributes synchronously to OPC server.

The Write Service is used to write one or more attributes of one or more nodes. For the Value Attribute the Write rights are indicated by the AccessLevel and UserAccessLevel Attribute of the Variable.

Parameters
nodesToWriteList of nodes and attributes to write.
settingsThe general settings for the request. If null, the default settings from the property DefaultRequestSettings are used.
Returns
A list of StatusCodes that indicate for each node if the write operation has been successful.
List<StatusCode> UnifiedAutomation.UaClient.Session.Write ( IList< WriteValue nodesToWrite)
inline

Writes attributes synchronously to OPC server.

The Write Service is used to write one or more attributes of one or more nodes. For the Value Attribute the Write rights are indicated by the AccessLevel and UserAccessLevel Attribute of the Variable.

Parameters
nodesToWriteThe nodes to write.
Returns

Property Documentation

IList<string> UnifiedAutomation.UaClient.Session.AlternativeEndpointUrls
getset

Gets or sets the alternative endpoint urls.

The alternative endpoint urls.

ApplicationInstance UnifiedAutomation.UaClient.Session.Application
getset

Gets the application.

bool UnifiedAutomation.UaClient.Session.AutomaticReconnect
getset

Gets or sets a value indicating whether the session should automatically reconnect on error.

true if the session should automatically reconnect; otherwise, false.

CacheManager UnifiedAutomation.UaClient.Session.Cache
getset

Gets the cache manager.

ServerConnectionStatus UnifiedAutomation.UaClient.Session.ConnectionStatus
getset

Gets the server connection status.

The server connection status.

RequestSettings UnifiedAutomation.UaClient.Session.DefaultRequestSettings
getset

Gets or sets the default settings used as fallback for OPC UA service calls.

The default request settings include a timeout, diagnostic settings, request id, and maximum number of operations per request.

TimestampsToReturn UnifiedAutomation.UaClient.Session.DefaultTimestampToReturn
getset

Gets or sets the default timestamp to return.

The default timestamp to return.

EndpointDescription UnifiedAutomation.UaClient.Session.EndpointDescription
getset

Gets or sets the endpoint description.

The endpoint description.

EncodeableFactory UnifiedAutomation.UaClient.Session.Factory
get

Gets the dictionary of data types known to the stack.

MessageContext UnifiedAutomation.UaClient.Session.MessageContext
get

Gets the message context.

ModelManager UnifiedAutomation.UaClient.Session.Model
getset

Gets the model manager.

NamespaceTable UnifiedAutomation.UaClient.Session.NamespaceUris
get

Gets the namespace uris.

IList<string> UnifiedAutomation.UaClient.Session.PreferredLocales
getset

Gets or sets the preferred locales.

The preferred locales.

uint UnifiedAutomation.UaClient.Session.PublishPipelineDepth
getset

Gets or sets the publish pipeline depth.

The publish pipeline depth.

uint UnifiedAutomation.UaClient.Session.ReconnectDelay
getset

Gets or sets the delay between reconnect attempts.

The delay between reconnect attempts.

int UnifiedAutomation.UaClient.Session.SecureChannelLifetime
getset

Gets or sets the secure channel lifetime.

The secure channel lifetime.

int UnifiedAutomation.UaClient.Session.SecureChannelTimeout
getset

Gets or sets the secure channel timeout.

The secure channel timeout.

StringTable UnifiedAutomation.UaClient.Session.ServerUris
get

Gets the server uris.

NodeId UnifiedAutomation.UaClient.Session.SessionId
get

Gets the session id.

string UnifiedAutomation.UaClient.Session.SessionName
getset

Gets or sets the name of the session.

The name of the session.

int UnifiedAutomation.UaClient.Session.SessionTimeout
getset

Gets or sets the session timeout.

The session timeout.

bool UnifiedAutomation.UaClient.Session.UseDnsNameAndPortFromDiscoveryUrl
getset

Gets or sets a value indicating whether to use DNS name and port from discovery URL when connecting to a server.

true if the DNS name and port from discovery URL should be used when connecting to a server; otherwise, false.

Sometimes the DNS name of the server is not accessible to the Client. Setting this flag will automatically use the DNS name of the URL passed to the Connect method when connecting to the server. Note that setting this flag to true makes it easier for hackers to trick clients into revealing confidential information (such as passwords) by redirecting clients to a rogue gateway.

Object UnifiedAutomation.UaClient.Session.UserData
getset

Gets or sets the user data.

The user data.

UserIdentity UnifiedAutomation.UaClient.Session.UserIdentity
getset

Gets or sets the user identity.

The user identity.

uint UnifiedAutomation.UaClient.Session.WatchdogCycleTime
getset

Gets or sets the watchdog cycle time.

The watchdog cycle time.

uint UnifiedAutomation.UaClient.Session.WatchdogTimeout
getset

Gets or sets the watchdog timeout.

The watchdog timeout.

Event Documentation

ServerConnectionStatusUpdateEventHandler UnifiedAutomation.UaClient.Session.ConnectionStatusUpdate

Raised when the connection status has been updated.

The SDK automatically detects if the target is a GUI control and ensures that the callback is invoked on the correct thread.

SessionValidationEventHandler UnifiedAutomation.UaClient.Session.SessionValidationError

Raised when a non-fatal error occurs during session establishment.

The SDK automatically detects if the target is a GUI control and ensures that the callback is invoked on the correct thread.

UpdateEndpointEventHandler UnifiedAutomation.UaClient.Session.UpdateEndpoint

Raised before connecting to the server and it allows the application to modify the endpoint used to connect.

The SDK automatically detects if the target is a GUI control and ensures that the callback is invoked on the correct thread. If the target is a GUI control and the synchronous Connect method can be used, this EventHandler must not show a dialog.


The documentation for this class was generated from the following file: