# OrleansServiceClientExtensions Methods

- Package: [Aspire.Hosting.Orleans](/reference/api/csharp/aspire.hosting.orleans.md)
- Type: [OrleansServiceClientExtensions](/reference/api/csharp/aspire.hosting.orleans/orleansserviceclientextensions.md)
- Kind: `Methods`
- Members: `1`

Extension methods for [OrleansServiceClient](/reference/api/csharp/aspire.hosting.orleans/orleansserviceclient.md).

## WithReference(IResourceBuilder<T>, OrleansServiceClient)

- Name: `WithReference(IResourceBuilder<T>, OrleansServiceClient)`
- Modifiers: `extension`
- Returns: `IResourceBuilder<T>`
- Source: [GitHub](https://github.com/microsoft/aspire/blob/cbc352350f1a9bafbaff10d14a2c8de4ac186a48/src/Aspire.Hosting.Orleans/OrleansServiceClientExtensions.cs#L27)

Adds an Orleans client to the resource.

```csharp
public static class OrleansServiceClientExtensions
{
    public static IResourceBuilder<T> WithReference<T>(
        this IResourceBuilder<T> builder,
        OrleansServiceClient orleansServiceClient)
    {
        // ...
    }
}
```

## Parameters

- `builder` (`IResourceBuilder<T>`)
  The builder on which add the Orleans service builder.
- `orleansServiceClient` ([OrleansServiceClient](/reference/api/csharp/aspire.hosting.orleans/orleansserviceclient.md))
  The Orleans service client, containing clustering, etc.

## Returns

`IResourceBuilder<T>` -- The resource builder.

## Exceptions

- `InvalidOperationException` -- Clustering has not been configured.

## ATS metadata

### ATS export

- Available to Polyglot AppHosts through the Aspire Type System.