# IOpcAddNodesService Members

> Reference: Defines a specialized IOpcService<TResponse, TRequest> which can be used to add one or more nodes into the address space hierarchy.

<dl class="api-definition">
<dt>Type</dt>
<dd><a href="./">IOpcAddNodesService</a></dd>
<dt>Namespace</dt>
<dd><a href="../namespaces/opc.uafx.services">Opc.UaFx.Services</a></dd>
<dt>Assembly</dt>
<dd>Opc.UaFx.Advanced.dll</dd>
<dt>Package</dt>
<dd>Opc.UaFx.Advanced v2.59.0</dd>
<dt>Also in</dt>
<dd>Opc.UaFx.Client</dd>
</dl>

Inherits members from [IOpcService&lt;OpcAddNodesResponse, OpcAddNodesRequest&gt;](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.services.iopcservice-2/members).

## Methods

### AddNodes

<span class="api-meta">2 overloads · since v2.7</span>

| Overload | Description |
|---|---|
| [AddNodes(IEnumerable&lt;OpcAddNode&gt;)](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.services.iopcaddnodesservice/members#addnodes-system-collections-generic-ienumerable-of-opc-uafx-opcaddnode)<span class="api-meta">since v2.7</span> | Adds one or more nodes into the address space hierarchy using the `commands` specified. |
| [AddNodes(params OpcAddNode\[\])](#addnodes-opc-uafx-opcaddnode-array)<span class="api-meta">since v2.7</span> | Adds one or more nodes into the address space hierarchy using the `commands` specified. |

**Exceptions (all overloads)**

| 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 add node service is currently not supported, especially using the `commands` specified. |
| [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). |

#### AddNodes(IEnumerable&lt;OpcAddNode&gt;)

<span class="api-meta">since v2.7</span>

Adds one or more nodes into the address space hierarchy using the `commands` specified.

<div class="api-signature" data-lang="csharp">

```csharp
OpcAddNodeResultCollection AddNodes(IEnumerable<OpcAddNode> commands)
```

</div>

<div class="api-signature" data-lang="vbnet">

```vbnet
Function AddNodes(
    commands As IEnumerable(Of OpcAddNode)) As OpcAddNodeResultCollection
```

</div>

**Parameters**

| Name | Type | Description |
|---|---|---|
| `commands` | [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable-1)&lt;[OpcAddNode](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcaddnode/)&gt; | A sequence of [OpcAddNode](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcaddnode/) instances to process. |

**Returns**

[OpcAddNodeResultCollection](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcaddnoderesultcollection/)

An instance of the [OpcAddNodeResultCollection](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcaddnoderesultcollection/) class which contains the node identifiers used or created for the nodes added through the `commands` specified; together with information about the outcome of each processed command.

**Remarks**

Known results for the `commands` specified are:

| Status | Description |
|---|---|
| [BadParentNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badparentnodeidinvalid) | The parent node id does not refer to a valid node. |
| [BadReferenceTypeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badreferencetypeidinvalid) | For more details see [BadReferenceTypeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badreferencetypeidinvalid). |
| [BadReferenceNotAllowed](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badreferencenotallowed) | The reference could not be created because it violates constraints imposed by the data model. |
| [BadNodeIdRejected](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidrejected) | The requested node id is already used by another node. |
| [BadNodeClassInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeclassinvalid) | For more details see [BadNodeClassInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeclassinvalid). |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | For more details see [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid). |
| [BadBrowseNameDuplicated](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameduplicated) | The browse name is not unique among nodes that share the same relationship with the parent. |
| [BadNodeAttributesInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeattributesinvalid) | The node attributes are not valid for the node class. |
| [BadTypeDefinitionInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtypedefinitioninvalid) | For more details see [BadTypeDefinitionInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtypedefinitioninvalid). |
| [BadUserAccessDenied](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#baduseraccessdenied) | For more details see [BadUserAccessDenied](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#baduseraccessdenied). |

#### AddNodes(params OpcAddNode\[\])

<span class="api-meta">since v2.7</span>

Adds one or more nodes into the address space hierarchy using the `commands` specified.

<div class="api-signature" data-lang="csharp">

```csharp
OpcAddNodeResultCollection AddNodes(params OpcAddNode[] commands)
```

</div>

<div class="api-signature" data-lang="vbnet">

```vbnet
Function AddNodes(
    ParamArray commands As OpcAddNode()) As OpcAddNodeResultCollection
```

</div>

**Parameters**

| Name | Type | Description |
|---|---|---|
| `commands` | params [OpcAddNode](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcaddnode/)[] | An array of [OpcAddNode](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcaddnode/) instances to process. |

**Returns**

[OpcAddNodeResultCollection](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcaddnoderesultcollection/)

An instance of the [OpcAddNodeResultCollection](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcaddnoderesultcollection/) class which contains the node identifiers used or created for the nodes added through the `commands` specified; together with information about the outcome of each processed command.

**Remarks**

Known results for the `commands` specified are:

| Status | Description |
|---|---|
| [BadParentNodeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badparentnodeidinvalid) | The parent node id does not refer to a valid node. |
| [BadReferenceTypeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badreferencetypeidinvalid) | For more details see [BadReferenceTypeIdInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badreferencetypeidinvalid). |
| [BadReferenceNotAllowed](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badreferencenotallowed) | The reference could not be created because it violates constraints imposed by the data model. |
| [BadNodeIdRejected](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeidrejected) | The requested node id is already used by another node. |
| [BadNodeClassInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeclassinvalid) | For more details see [BadNodeClassInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeclassinvalid). |
| [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid) | For more details see [BadBrowseNameInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameinvalid). |
| [BadBrowseNameDuplicated](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badbrowsenameduplicated) | The browse name is not unique among nodes that share the same relationship with the parent. |
| [BadNodeAttributesInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badnodeattributesinvalid) | The node attributes are not valid for the node class. |
| [BadTypeDefinitionInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtypedefinitioninvalid) | For more details see [BadTypeDefinitionInvalid](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#badtypedefinitioninvalid). |
| [BadUserAccessDenied](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#baduseraccessdenied) | For more details see [BadUserAccessDenied](https://www.traeger.de/en/docs/development/opcua/api/v2.59/opc.uafx.opcstatuscode/#baduseraccessdenied). |