# OpcClient.TranslatePaths Method
> Reference: Translates paths starting from the root node using the pathsElements specified.
- Type
- OpcClient
- Namespace
- Opc.UaFx.Client
- Assembly
- Opc.UaFx.Advanced.dll
- Package
- Opc.UaFx.Advanced v2.59.0
- Members
- OpcClient Members
- Also in
- Opc.UaFx.Client
16 overloads ยท since v2.18
| Overload | Description |
|---|---|
| [TranslatePaths(params IEnumerable<OpcName>\[\])](#translatepaths-system-collections-generic-ienumerable-of-opc-uafx-opcname-array)since v2.18 | Translates paths starting from the root node using the `pathsElements` specified. |
| [TranslatePaths(IEnumerable<IEnumerable<OpcName>>)](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.client.opcclient/translatepaths#translatepaths-system-collections-generic-ienumerable-of-system-collections-generic-ienumerable-of-opc-uafx-opcname)since v2.18 | Translates paths starting from the root node using the `pathsElements` specified. |
| [TranslatePaths(OpcNodeId, params IEnumerable<OpcName>\[\])](#translatepaths-opc-uafx-opcnodeid-system-collections-generic-ienumerable-of-opc-uafx-opcname-array)since v2.18 | Translates paths starting from the node identified by the `nodeId` specified using the `pathsElements` passed. |
| [TranslatePaths(OpcNodeId, IEnumerable<IEnumerable<OpcName>>)](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.client.opcclient/translatepaths#translatepaths-opc-uafx-opcnodeid-system-collections-generic-ienumerable-of-system-collections-generic-ienumerable-of-opc-uafx-opcname)since v2.18 | Translates paths starting from the node identified by the `nodeId` specified using the `pathsElements` passed. |
| [TranslatePaths(params IEnumerable<OpcRelativePathElement>\[\])](#translatepaths-system-collections-generic-ienumerable-of-opc-uafx-opcrelativepathelement-array)since v2.18 | Translates a path starting from the root node using the `pathsElements` specified. |
| [TranslatePaths(IEnumerable<IEnumerable<OpcRelativePathElement>>)](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.client.opcclient/translatepaths#translatepaths-system-collections-generic-ienumerable-of-system-collections-generic-ienumerable-of-opc-uafx-opcrelativepathelement)since v2.18 | Translates paths starting from the root node using the `pathsElements` specified. |
| [TranslatePaths(OpcNodeId, params IEnumerable<OpcRelativePathElement>\[\])](#translatepaths-opc-uafx-opcnodeid-system-collections-generic-ienumerable-of-opc-uafx-opcrelativepathelement-array)since v2.18 | Translates paths starting from the node identified by the `nodeId` specified using the `pathsElements` passed. |
| [TranslatePaths(OpcNodeId, IEnumerable<IEnumerable<OpcRelativePathElement>>)](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.client.opcclient/translatepaths#translatepaths-opc-uafx-opcnodeid-system-collections-generic-ienumerable-of-system-collections-generic-ienumerable-of-opc-uafx-opcrelativepathelement)since v2.18 | Translates paths starting from the node identified by the `nodeId` specified using the `pathsElements` passed. |
| [TranslatePaths(params string\[\])](#translatepaths-system-string-array)since v2.18 | Translates the `paths` starting from the root node. |
| [TranslatePaths(IEnumerable<string>)](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.client.opcclient/translatepaths#translatepaths-system-collections-generic-ienumerable-of-system-string)since v2.18 | Translates the `paths` starting from the root node. |
| [TranslatePaths(OpcNodeId, params string\[\])](#translatepaths-opc-uafx-opcnodeid-system-string-array)since v2.18 | Translates the `paths` starting from the node identified by the `nodeId` specified. |
| [TranslatePaths(OpcNodeId, IEnumerable<string>)](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.client.opcclient/translatepaths#translatepaths-opc-uafx-opcnodeid-system-collections-generic-ienumerable-of-system-string)since v2.18 | Translates the `paths` starting from the node identified by the `nodeId` specified. |
| [TranslatePaths(OpcNodeId, params OpcRelativePath\[\])](#translatepaths-opc-uafx-opcnodeid-opc-uafx-opcrelativepath-array)since v2.18 | Translates the `paths` starting from the node identified by the `nodeId` specified. |
| [TranslatePaths(OpcNodeId, IEnumerable<OpcRelativePath>)](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.client.opcclient/translatepaths#translatepaths-opc-uafx-opcnodeid-system-collections-generic-ienumerable-of-opc-uafx-opcrelativepath)since v2.18 | Translates the `paths` starting from the node identified by the `nodeId` specified. |
| [TranslatePaths(IEnumerable<OpcTranslatePath>)](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.client.opcclient/translatepaths#translatepaths-system-collections-generic-ienumerable-of-opc-uafx-opctranslatepath)since v2.18 | Translates one or more paths starting from one or more dedicated nodes using the specified `commands`. |
| [TranslatePaths(params OpcTranslatePath\[\])](#translatepaths-opc-uafx-opctranslatepath-array)since v2.18 | Translates one or more paths starting from one or more dedicated nodes using the specified `commands`. |
**Exceptions (all overloads)**
| Exception | Condition |
|---|---|
| [OpcException](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcexception/) | The service execution failed upon different circumstances; for more details see exception details. The following issues can lead to that exception: [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) and [BadTooManyOperations](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanyoperations). |
## TranslatePaths(params IEnumerable<OpcName>\[\])
since v2.18
Translates paths starting from the root node using the `pathsElements` specified.
```csharp
public IEnumerable TranslatePaths(
params IEnumerable[] pathsElements)
```
```vbnet
Public Function TranslatePaths(
ParamArray pathsElements As IEnumerable(Of OpcName)()) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `pathsElements` | params [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/)>[] | An array of sequences of [OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/) objects representing the value of the [BrowseName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcattribute/#browsename) attribute of the nodes to visit to translate the last [OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/) item in a sequence in `pathsElements` to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `pathsElements` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `pathsElements` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `pathsElements` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(IEnumerable<IEnumerable<OpcName>>)
since v2.18
Translates paths starting from the root node using the `pathsElements` specified.
```csharp
public IEnumerable TranslatePaths(
IEnumerable> pathsElements)
```
```vbnet
Public Function TranslatePaths(
pathsElements As IEnumerable(Of IEnumerable(Of OpcName))) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `pathsElements` | [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/)>> | A sequence of sequences of [OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/) objects representing the value of the [BrowseName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcattribute/#browsename) attribute of the nodes to visit to translate the last [OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/) item in a sequence in `pathsElements` to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `pathsElements` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `pathsElements` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `pathsElements` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(OpcNodeId, params IEnumerable<OpcName>\[\])
since v2.18
Translates paths starting from the node identified by the `nodeId` specified using the `pathsElements` passed.
```csharp
public IEnumerable TranslatePaths(
OpcNodeId nodeId,
params IEnumerable[] pathsElements)
```
```vbnet
Public Function TranslatePaths(
nodeId As OpcNodeId,
ParamArray pathsElements As IEnumerable(Of OpcName)()) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `nodeId` | [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) | The [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) of the node on which the service will translate the `pathsElements`. |
| `pathsElements` | params [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/)>[] | An array of sequences of [OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/) objects representing the value of the [BrowseName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcattribute/#browsename) attribute of the nodes to visit to translate the last [OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/) item in a sequence in `pathsElements` to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `pathsElements` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `pathsElements` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `pathsElements` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(OpcNodeId, IEnumerable<IEnumerable<OpcName>>)
since v2.18
Translates paths starting from the node identified by the `nodeId` specified using the `pathsElements` passed.
```csharp
public IEnumerable TranslatePaths(
OpcNodeId nodeId,
IEnumerable> pathsElements)
```
```vbnet
Public Function TranslatePaths(
nodeId As OpcNodeId,
pathsElements As IEnumerable(Of IEnumerable(Of OpcName))) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `nodeId` | [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) | The [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) of the node on which the service will translate the `pathsElements`. |
| `pathsElements` | [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/)>> | A sequence of sequences of [OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/) objects representing the value of the [BrowseName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcattribute/#browsename) attribute of the nodes to visit to translate the last [OpcName](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcname/) item in a sequence in `pathsElements` to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `pathsElements` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `pathsElements` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `pathsElements` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(params IEnumerable<OpcRelativePathElement>\[\])
since v2.18
Translates a path starting from the root node using the `pathsElements` specified.
```csharp
public IEnumerable TranslatePaths(
params IEnumerable[] pathsElements)
```
```vbnet
Public Function TranslatePaths(
ParamArray pathsElements As IEnumerable(Of OpcRelativePathElement)()) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `pathsElements` | params [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/)>[] | An array of sequences of [OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/) objects representing the translation directives of the nodes to visit to translate the last [OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/) item a sequence in `pathsElements` to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `pathsElements` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `pathsElements` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `pathsElements` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(IEnumerable<IEnumerable<OpcRelativePathElement>>)
since v2.18
Translates paths starting from the root node using the `pathsElements` specified.
```csharp
public IEnumerable TranslatePaths(
IEnumerable> pathsElements)
```
```vbnet
Public Function TranslatePaths(
pathsElements As IEnumerable(Of IEnumerable(Of OpcRelativePathElement))) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `pathsElements` | [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/)>> | A sequence of sequences of [OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/) objects representing the translation directives of the nodes to visit to translate the last [OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/) item in a sequence in `pathsElements` to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `pathsElements` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `pathsElements` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `pathsElements` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(OpcNodeId, params IEnumerable<OpcRelativePathElement>\[\])
since v2.18
Translates paths starting from the node identified by the `nodeId` specified using the `pathsElements` passed.
```csharp
public IEnumerable TranslatePaths(
OpcNodeId nodeId,
params IEnumerable[] pathsElements)
```
```vbnet
Public Function TranslatePaths(
nodeId As OpcNodeId,
ParamArray pathsElements As IEnumerable(Of OpcRelativePathElement)()) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `nodeId` | [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) | The [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) of the node on which the service will translate the `pathsElements`. |
| `pathsElements` | params [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/)>[] | An array of sequences of [OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/) objects representing the translation directives of the nodes to visit to translate the last [OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/) item in a sequence of `pathsElements` to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `pathsElements` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `pathsElements` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `pathsElements` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(OpcNodeId, IEnumerable<IEnumerable<OpcRelativePathElement>>)
since v2.18
Translates paths starting from the node identified by the `nodeId` specified using the `pathsElements` passed.
```csharp
public IEnumerable TranslatePaths(
OpcNodeId nodeId,
IEnumerable> pathsElements)
```
```vbnet
Public Function TranslatePaths(
nodeId As OpcNodeId,
pathsElements As IEnumerable(Of IEnumerable(Of OpcRelativePathElement))) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `nodeId` | [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) | The [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) of the node on which the service will translate the `pathsElements`. |
| `pathsElements` | [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/)>> | A sequence of sequences of [OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/) objects representing the translation directives of the nodes to visit to translate the last [OpcRelativePathElement](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepathelement/) item in a sequence of `pathsElements` to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `pathsElements` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `pathsElements` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `pathsElements` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(params string\[\])
since v2.18
Translates the `paths` starting from the root node.
```csharp
public IEnumerable TranslatePaths(params string[] paths)
```
```vbnet
Public Function TranslatePaths(
ParamArray paths As String()) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `paths` | params [String](https://learn.microsoft.com/dotnet/api/system.string)[] | An array of [string](https://learn.microsoft.com/dotnet/api/system.string) instances representing a [OpcRelativePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepath/) to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `paths` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `paths` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `paths` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(IEnumerable<string>)
since v2.18
Translates the `paths` starting from the root node.
```csharp
public IEnumerable TranslatePaths(IEnumerable paths)
```
```vbnet
Public Function TranslatePaths(
paths As IEnumerable(Of String)) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `paths` | [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[String](https://learn.microsoft.com/dotnet/api/system.string)> | A sequence of [string](https://learn.microsoft.com/dotnet/api/system.string) instances representing a [OpcRelativePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepath/) to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `paths` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `paths` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `paths` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(OpcNodeId, params string\[\])
since v2.18
Translates the `paths` starting from the node identified by the `nodeId` specified.
```csharp
public IEnumerable TranslatePaths(
OpcNodeId nodeId,
params string[] paths)
```
```vbnet
Public Function TranslatePaths(
nodeId As OpcNodeId,
ParamArray paths As String()) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `nodeId` | [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) | The [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) of the node on which the service will translate the `paths`. |
| `paths` | params [String](https://learn.microsoft.com/dotnet/api/system.string)[] | An array of [string](https://learn.microsoft.com/dotnet/api/system.string) instances representing a [OpcRelativePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepath/) to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `paths` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `paths` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `paths` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(OpcNodeId, IEnumerable<string>)
since v2.18
Translates the `paths` starting from the node identified by the `nodeId` specified.
```csharp
public IEnumerable TranslatePaths(
OpcNodeId nodeId,
IEnumerable paths)
```
```vbnet
Public Function TranslatePaths(
nodeId As OpcNodeId,
paths As IEnumerable(Of String)) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `nodeId` | [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) | The [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) of the node on which the service will translate the `paths`. |
| `paths` | [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[String](https://learn.microsoft.com/dotnet/api/system.string)> | A sequence of [string](https://learn.microsoft.com/dotnet/api/system.string) instances representing a [OpcRelativePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepath/) to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `paths` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `paths` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `paths` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(OpcNodeId, params OpcRelativePath\[\])
since v2.18
Translates the `paths` starting from the node identified by the `nodeId` specified.
```csharp
public IEnumerable TranslatePaths(
OpcNodeId nodeId,
params OpcRelativePath[] paths)
```
```vbnet
Public Function TranslatePaths(
nodeId As OpcNodeId,
ParamArray paths As OpcRelativePath()) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `nodeId` | [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) | The [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) of the node on which the service will translate the `paths`. |
| `paths` | params [OpcRelativePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepath/)[] | An array of [OpcRelativePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepath/) instances to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `paths` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `paths` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `paths` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(OpcNodeId, IEnumerable<OpcRelativePath>)
since v2.18
Translates the `paths` starting from the node identified by the `nodeId` specified.
```csharp
public IEnumerable TranslatePaths(
OpcNodeId nodeId,
IEnumerable paths)
```
```vbnet
Public Function TranslatePaths(
nodeId As OpcNodeId,
paths As IEnumerable(Of OpcRelativePath)) As IEnumerable(Of OpcNodeId)
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `nodeId` | [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) | The [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/) of the node on which the service will translate the `paths`. |
| `paths` | [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcRelativePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepath/)> | A sequence of [OpcRelativePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcrelativepath/) instances to the [OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)s requested by the service. |
**Returns**
[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcNodeId](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcnodeid/)>
The target identifiers the `paths` could translated to.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `paths` or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `paths` specified. |
| [ObjectDisposedException](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception) | The object has been disposed of. |
**Remarks**
Known results for this method are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(IEnumerable<OpcTranslatePath>)
since v2.18
Translates one or more paths starting from one or more dedicated nodes using the specified `commands`.
```csharp
public OpcTranslatePathResultCollection TranslatePaths(
IEnumerable commands)
```
```vbnet
Public Function TranslatePaths(
commands As IEnumerable(Of OpcTranslatePath)) As OpcTranslatePathResultCollection
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `commands` | [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)<[OpcTranslatePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opctranslatepath/)> | A sequence of [OpcTranslatePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opctranslatepath/) instances to process. |
**Returns**
[OpcTranslatePathResultCollection](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opctranslatepathresultcollection/)
An instance of the [OpcTranslatePathResultCollection](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opctranslatepathresultcollection/) class which contains the target identifiers the paths were translated to through the `commands` specified; together with information about the outcome of each processed command.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `commands` sequence or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `commands` specified. |
**Remarks**
Known results for the `commands` specified are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |
## TranslatePaths(params OpcTranslatePath\[\])
since v2.18
Translates one or more paths starting from one or more dedicated nodes using the specified `commands`.
```csharp
public OpcTranslatePathResultCollection TranslatePaths(
params OpcTranslatePath[] commands)
```
```vbnet
Public Function TranslatePaths(
ParamArray commands As OpcTranslatePath()) As OpcTranslatePathResultCollection
```
**Parameters**
| Name | Type | Description |
|---|---|---|
| `commands` | params [OpcTranslatePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opctranslatepath/)[] | An array of [OpcTranslatePath](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opctranslatepath/) instances to process. |
**Returns**
[OpcTranslatePathResultCollection](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opctranslatepathresultcollection/)
An instance of the [OpcTranslatePathResultCollection](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opctranslatepathresultcollection/) class which contains the target identifiers the paths were translated to through the `commands` specified; together with information about the outcome of each processed command.
**Exceptions**
| Exception | Condition |
|---|---|
| [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception) | The `commands` sequence or one of its items is a null reference (Nothing in Visual Basic). |
| [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception) | The translate path service is currently not supported, especially using the `commands` specified. |
**Remarks**
Known results for the `commands` specified are:
| Status | Description |
|---|---|
| [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid) | For more details see [BadNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidinvalid). |
| [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown) | For more details see [BadNodeIdUnknown](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidunknown). |
| [BadNothingToDo](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnothingtodo) | This code indicates that the relativePath contained an empty list. |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | This code indicates that a TargetName was missing in a RelativePath. |
| [UncertainReferenceOutOfServer](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#uncertainreferenceoutofserver) | The path element has targets which are in another server. |
| [BadTooManyMatches](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtoomanymatches) | The requested operation has too many matches to return. Users should use queries for large result sets. Servers should allow at least 10 matches before returning this error code. |
| [BadQueryTooComplex](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badquerytoocomplex) | The requested operation requires too many resources in the server. |
| [BadNoMatch](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnomatch) | The requested relativePath cannot be resolved to a target to return. |