# DistributedApplicationTestingBuilder Methods

- Package: [Aspire.Hosting.Testing](/reference/api/csharp/aspire.hosting.testing.md)
- Type: [DistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/distributedapplicationtestingbuilder.md)
- Kind: `Methods`
- Members: `8`

Methods for creating distributed application instances for testing purposes.

## Create(string[])

- Name: `Create(string[])`
- Modifiers: `static`
- Returns: [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md)
- Source: [GitHub](https://github.com/microsoft/aspire/blob/5bd693ae1897dee5e2ce71c2cc08879c1c7eff51/src/Aspire.Hosting.Testing/DistributedApplicationTestingBuilder.cs#L126)

Creates a new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

```csharp
public static class DistributedApplicationTestingBuilder
{
    public static IDistributedApplicationTestingBuilder Create(
        params string[] args)
    {
        // ...
    }
}
```

## Parameters

- `args` (`string[]`)
  The command line arguments to pass to the entry point.

## Returns

[IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md) -- A new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

## Create(string[], Action<DistributedApplicationOptions, HostApplicationBuilderSettings>)

- Name: `Create(string[], Action<DistributedApplicationOptions, HostApplicationBuilderSettings>)`
- Modifiers: `static`
- Returns: [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md)
- Source: [GitHub](https://github.com/microsoft/aspire/blob/5bd693ae1897dee5e2ce71c2cc08879c1c7eff51/src/Aspire.Hosting.Testing/DistributedApplicationTestingBuilder.cs#L138-L141)

Creates a new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

```csharp
public static class DistributedApplicationTestingBuilder
{
    public static IDistributedApplicationTestingBuilder Create(
        string[] args,
        Action<DistributedApplicationOptions, HostApplicationBuilderSettings> configureBuilder)
    {
        // ...
    }
}
```

## Parameters

- `args` (`string[]`)
  The command line arguments to pass to the entry point.
- `configureBuilder` (`Action<DistributedApplicationOptions, HostApplicationBuilderSettings>`)
  The delegate used to configure the builder.

## Returns

[IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md) -- A new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

## CreateAsync(CancellationToken)

- Name: `CreateAsync(CancellationToken)`
- Modifiers: `static`
- Returns: [Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md)
- Source: [GitHub](https://github.com/microsoft/aspire/blob/5bd693ae1897dee5e2ce71c2cc08879c1c7eff51/src/Aspire.Hosting.Testing/DistributedApplicationTestingBuilder.cs#L38)

Creates a new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

```csharp
public static class DistributedApplicationTestingBuilder
{
    public static Task<IDistributedApplicationTestingBuilder> CreateAsync<TEntryPoint>(
        CancellationToken cancellationToken = default(CancellationToken))
    {
        // ...
    }
}
```

## Parameters

- `cancellationToken` (`CancellationToken`) `optional`
  The `Threading.CancellationToken`.

## Returns

[Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md) -- A new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

## CreateAsync(Type, CancellationToken)

- Name: `CreateAsync(Type, CancellationToken)`
- Modifiers: `static`
- Returns: [Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md)
- Source: [GitHub](https://github.com/microsoft/aspire/blob/5bd693ae1897dee5e2ce71c2cc08879c1c7eff51/src/Aspire.Hosting.Testing/DistributedApplicationTestingBuilder.cs#L50)

Creates a new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

```csharp
public static class DistributedApplicationTestingBuilder
{
    public static Task<IDistributedApplicationTestingBuilder> CreateAsync(
        Type entryPoint,
        CancellationToken cancellationToken = default(CancellationToken))
    {
        // ...
    }
}
```

## Parameters

- `entryPoint` (`Type`)
  A type in the entry point assembly of the target Aspire AppHost. Typically, the Program class can be used.
- `cancellationToken` (`CancellationToken`) `optional`
  The `Threading.CancellationToken`.

## Returns

[Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md) -- A new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

## CreateAsync(string[], CancellationToken)

- Name: `CreateAsync(string[], CancellationToken)`
- Modifiers: `static`
- Returns: [Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md)
- Source: [GitHub](https://github.com/microsoft/aspire/blob/5bd693ae1897dee5e2ce71c2cc08879c1c7eff51/src/Aspire.Hosting.Testing/DistributedApplicationTestingBuilder.cs#L66)

Creates a new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

```csharp
public static class DistributedApplicationTestingBuilder
{
    public static Task<IDistributedApplicationTestingBuilder> CreateAsync<TEntryPoint>(
        string[] args,
        CancellationToken cancellationToken = default(CancellationToken))
    {
        // ...
    }
}
```

## Parameters

- `args` (`string[]`)
  The command line arguments to pass to the entry point.
- `cancellationToken` (`CancellationToken`) `optional`
  The `Threading.CancellationToken`.

## Returns

[Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md) -- A new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

## CreateAsync(Type, string[], CancellationToken)

- Name: `CreateAsync(Type, string[], CancellationToken)`
- Modifiers: `static`
- Returns: [Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md)
- Source: [GitHub](https://github.com/microsoft/aspire/blob/5bd693ae1897dee5e2ce71c2cc08879c1c7eff51/src/Aspire.Hosting.Testing/DistributedApplicationTestingBuilder.cs#L79)

Creates a new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

```csharp
public static class DistributedApplicationTestingBuilder
{
    public static Task<IDistributedApplicationTestingBuilder> CreateAsync(
        Type entryPoint,
        string[] args,
        CancellationToken cancellationToken = default(CancellationToken))
    {
        // ...
    }
}
```

## Parameters

- `entryPoint` (`Type`)
  A type in the entry point assembly of the target Aspire AppHost. Typically, the Program class can be used.
- `args` (`string[]`)
  The command line arguments to pass to the entry point.
- `cancellationToken` (`CancellationToken`) `optional`
  The `Threading.CancellationToken`.

## Returns

[Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md) -- A new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

## CreateAsync(string[], Action<DistributedApplicationOptions, HostApplicationBuilderSettings>, CancellationToken)

- Name: `CreateAsync(string[], Action<DistributedApplicationOptions, HostApplicationBuilderSettings>, CancellationToken)`
- Modifiers: `static`
- Returns: [Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md)
- Source: [GitHub](https://github.com/microsoft/aspire/blob/5bd693ae1897dee5e2ce71c2cc08879c1c7eff51/src/Aspire.Hosting.Testing/DistributedApplicationTestingBuilder.cs#L95)

Creates a new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

```csharp
public static class DistributedApplicationTestingBuilder
{
    public static Task<IDistributedApplicationTestingBuilder> CreateAsync<TEntryPoint>(
        string[] args,
        Action<DistributedApplicationOptions, HostApplicationBuilderSettings> configureBuilder,
        CancellationToken cancellationToken = default(CancellationToken))
    {
        // ...
    }
}
```

## Parameters

- `args` (`string[]`)
  The command line arguments to pass to the entry point.
- `configureBuilder` (`Action<DistributedApplicationOptions, HostApplicationBuilderSettings>`)
  The delegate used to configure the builder.
- `cancellationToken` (`CancellationToken`) `optional`
  The `Threading.CancellationToken`.

## Returns

[Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md) -- A new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

## CreateAsync(Type, string[], Action<DistributedApplicationOptions, HostApplicationBuilderSettings>, CancellationToken)

- Name: `CreateAsync(Type, string[], Action<DistributedApplicationOptions, HostApplicationBuilderSettings>, CancellationToken)`
- Modifiers: `static`
- Returns: [Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md)
- Source: [GitHub](https://github.com/microsoft/aspire/blob/5bd693ae1897dee5e2ce71c2cc08879c1c7eff51/src/Aspire.Hosting.Testing/DistributedApplicationTestingBuilder.cs)

Creates a new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).

```csharp
public static class DistributedApplicationTestingBuilder
{
    public static Task<IDistributedApplicationTestingBuilder> CreateAsync(
        Type entryPoint,
        string[] args,
        Action<DistributedApplicationOptions, HostApplicationBuilderSettings> configureBuilder,
        CancellationToken cancellationToken = default(CancellationToken))
    {
        // ...
    }
}
```

## Parameters

- `entryPoint` (`Type`)
  A type in the entry point assembly of the target Aspire AppHost. Typically, the Program class can be used.
- `args` (`string[]`)
  The command line arguments to pass to the entry point.
- `configureBuilder` (`Action<DistributedApplicationOptions, HostApplicationBuilderSettings>`)
  The delegate used to configure the builder.
- `cancellationToken` (`CancellationToken`) `optional`
  The `Threading.CancellationToken`.

## Returns

[Task<IDistributedApplicationTestingBuilder>](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md) -- A new instance of [IDistributedApplicationTestingBuilder](/reference/api/csharp/aspire.hosting.testing/idistributedapplicationtestingbuilder.md).