# AspireAppConfigurationExtensions Methods

- Package: [Aspire.Microsoft.Extensions.Configuration.AzureAppConfiguration](/reference/api/csharp/aspire.microsoft.extensions.configuration.azureappconfiguration.md)
- Type: [AspireAppConfigurationExtensions](/reference/api/csharp/aspire.microsoft.extensions.configuration.azureappconfiguration/aspireappconfigurationextensions.md)
- Kind: `Methods`
- Members: `1`

Provides extension methods for registering and configuring Azure App Configuration in an Aspire application.

## AddAzureAppConfiguration(IHostApplicationBuilder, string, Action<AzureAppConfigurationSettings>, Action<AzureAppConfigurationOptions>)

- Name: `AddAzureAppConfiguration(IHostApplicationBuilder, string, Action<AzureAppConfigurationSettings>, Action<AzureAppConfigurationOptions>)`
- Modifiers: `extension`
- Source: [GitHub](https://github.com/microsoft/aspire/blob/cbc352350f1a9bafbaff10d14a2c8de4ac186a48/src/Components/Aspire.Microsoft.Extensions.Configuration.AzureAppConfiguration/AspireAppConfigurationExtensions.cs#L53-L108)

Adds the Azure App Configuration to be configuration in the `builder`.

```csharp
public static class AspireAppConfigurationExtensions
{
    public static void AddAzureAppConfiguration(
        this IHostApplicationBuilder builder,
        string connectionName,
        Action<AzureAppConfigurationSettings>? configureSettings = null,
        Action<AzureAppConfigurationOptions>? configureOptions = null)
    {
        // ...
    }
}
```

## Parameters

- `builder` (`IHostApplicationBuilder`)
  The `Hosting.IHostApplicationBuilder` to read config from and add services to.
- `connectionName` (`string`)
  A name used to retrieve the connection string from the ConnectionStrings configuration section.
- `configureSettings` (`Action<AzureAppConfigurationSettings>`) `optional`
  An optional method that can be used for customizing the [AzureAppConfigurationSettings](/reference/api/csharp/aspire.microsoft.extensions.configuration.azureappconfiguration/azureappconfigurationsettings.md). It's invoked after the settings are read from the configuration.
- `configureOptions` (`Action<AzureAppConfigurationOptions>`) `optional`
  An optional method that can be used for customizing the `AzureAppConfiguration.AzureAppConfigurationOptions`.

## Exceptions

- `InvalidOperationException` -- Thrown when mandatory [AzureAppConfigurationSettings.Endpoint](/reference/api/csharp/aspire.microsoft.extensions.configuration.azureappconfiguration/azureappconfigurationsettings/properties.md#endpoint) is not provided.

## Remarks

Reads the settings from "Aspire:Microsoft:Extensions:Configuration:AzureAppConfiguration" section.