# HierarchicalKey.Append(HierarchicalKey)

[Type overview](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.hierarchicalkey/) | [Methods](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.hierarchicalkey/methods/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/HierarchicalKey.cs#L127-L129)

```csharp
public HierarchicalKey Append(HierarchicalKey suffix)
```

Composes this hierarchy with an already constructed suffix hierarchy.

### Parameters

- `suffix` (`HierarchicalKey`): The constructed suffix.

### Returns

A flat concatenated identity preserving both paths' segment boundaries.

### Exceptions

- `System.InvalidOperationException`: This key is unset.
- `System.ArgumentException`: `suffix` is unset.
