Parse Method (UANodeId)

Parses a string containing an OPC-UA node Id (its expanded text), and returns a corresponding node Id object.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
<NotNullAttribute()>
Public Shared Function Parse( _
   ByVal s As String, _
   ByVal defaultNamespaceUriString As String _
) As UANodeId

'Usage
 
Dim s As String
Dim defaultNamespaceUriString As String
Dim value As UANodeId
 
value = UANodeId.Parse(s, defaultNamespaceUriString)

[NotNull()]
public static UANodeId Parse( 
   string s,
   string defaultNamespaceUriString
)

[NotNull()]
public:
static UANodeId^ Parse( 
   String^ s,
   String^ defaultNamespaceUriString
)

Parameters

s

Expanded text of the node Id.

The value of this parameter cannot be null (Nothing in Visual Basic).

defaultNamespaceUriString

The default namespace to be used if no namespace is specified in the input string.

The value represents an OPC UA namespace URI string. Any string can be passed to this parameter (i.e. will not cause System.ArgumentException), but not all values make sense and will work when an operation using them is attempted.

The value of this parameter can be null (Nothing in Visual Basic).

Return Value

Returns the OPC-UA node Id object parsed from the input value.

Because there is an implicit conversion from UANodeId to OpcLabs.EasyOpc.UA.UANodeDescriptor, in languages that support implicit conversion operators (such as C# or VB.NET), you can simply use the returned UANodeId in any place where the OpcLabs.EasyOpc.UA.UANodeDescriptor is expected as input, and the corresponding node descriptor will be constructed automatically.

Also, because the UANodeId has an implicit conversion to System.String, and it converts to the expanded text of the node Id (ExpandedText), in languages that support implicit conversion operators (such as C# or VB.NET), you can simply use the returned UANodeId in any place where expanded text of a node Id (a string) is expected as input, and the corresponding expanded text will be taken automatically from the node Id.

This method never returns null (Nothing in Visual Basic).

Exceptions

Exception Description

Exception	Description
System.ArgumentNullException	A `null` reference (`Nothing` in Visual Basic) is passed to a method that does not accept it as a valid argument. This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.
OpcLabs.EasyOpc.UA.AddressSpace.Parsing.UANodeIdFormatException	The string format of the OPC-UA node ID is incorrect.

System.ArgumentNullException

A null reference (Nothing in Visual Basic) is passed to a method that does not accept it as a valid argument.

This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

OpcLabs.EasyOpc.UA.AddressSpace.Parsing.UANodeIdFormatException The string format of the OPC-UA node ID is incorrect.

Remarks

OPC UA node Id, represented by the UANodeId class, directly identifies a node in a server's address space.

Requirements

Target Platforms: .NET Framework: Windows 10 (selected versions), Windows 11 (selected versions), Windows Server 2016, Windows Server 2022; .NET: Linux, macOS, Microsoft Windows

Reference

UANodeId Class
UANodeId Members
OPC UA Node IDs
Namespace indices in OPC UA Node Ids

Documentation Home, Send Documentation Feedback. Technical Support