diff --git a/src/Microsoft.Extensions.Configuration.AzureAppConfiguration/AzureAppConfigurationExtensions.cs b/src/Microsoft.Extensions.Configuration.AzureAppConfiguration/AzureAppConfigurationExtensions.cs
index f8c2c5ca..8d141969 100644
--- a/src/Microsoft.Extensions.Configuration.AzureAppConfiguration/AzureAppConfigurationExtensions.cs
+++ b/src/Microsoft.Extensions.Configuration.AzureAppConfiguration/AzureAppConfigurationExtensions.cs
@@ -1,6 +1,7 @@
// Copyright (c) Microsoft Corporation.
// Licensed under the MIT license.
//
+using Azure.Core;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection.Extensions;
@@ -30,7 +31,10 @@ private static bool IsProviderDisabled()
}
///
- /// Adds key-value data from an Azure App Configuration store to a configuration builder.
+ /// Adds key-value data from an Azure App Configuration store to a configuration builder using its connection string.
+ /// This is a simplified overload that loads all key-values with no label. For advanced scenarios such as selecting specific keys,
+ /// filtering by labels, configuring refresh, using feature flags, or resolving Key Vault references,
+ /// use the overload that accepts an parameter with options.Connect().
///
/// The configuration builder to add key-values to.
/// The connection string used to connect to the configuration store.
@@ -47,7 +51,10 @@ public static IConfigurationBuilder AddAzureAppConfiguration(
}
///
- /// Adds key-value data from an Azure App Configuration store to a configuration builder.
+ /// Adds key-value data from a primary Azure App Configuration store and one or more replica stores to a configuration builder using connection strings.
+ /// This is a simplified overload that loads all key-values with no label. For advanced scenarios such as selecting specific keys,
+ /// filtering by labels, configuring refresh, using feature flags, or resolving Key Vault references,
+ /// use the overload that accepts an parameter with options.Connect().
///
/// The configuration builder to add key-values to.
/// The list of connection strings used to connect to the configuration store and its replicas.
@@ -64,7 +71,30 @@ public static IConfigurationBuilder AddAzureAppConfiguration(
}
///
- /// Adds key-value data from an Azure App Configuration store to a configuration builder.
+ /// Adds key-value data from an Azure App Configuration store to a configuration builder using endpoint with AAD authentication.
+ /// This is a simplified overload that loads all key-values with no label. For advanced scenarios such as selecting specific keys,
+ /// filtering by labels, configuring refresh, using feature flags, or resolving Key Vault references,
+ /// use the overload that accepts an parameter with options.Connect().
+ ///
+ /// The configuration builder to add key-values to.
+ /// The endpoint used to connect to the configuration store.
+ /// The token credential used to authenticate requests to the configuration store.
+ /// Determines the behavior of the App Configuration provider when an exception occurs while loading data from server. If false, the exception is thrown. If true, the exception is suppressed and no settings are populated from Azure App Configuration.
+ /// will always be thrown when the caller gives an invalid input configuration (connection strings, endpoints, key/label filters...etc).
+ ///
+ /// The provided configuration builder.
+ public static IConfigurationBuilder AddAzureAppConfiguration(
+ this IConfigurationBuilder configurationBuilder,
+ Uri endpoint,
+ TokenCredential credential,
+ bool optional = false)
+ {
+ return configurationBuilder.AddAzureAppConfiguration(options => options.Connect(endpoint, credential), optional);
+ }
+
+ ///
+ /// Adds key-value data from an Azure App Configuration store to a configuration builder using a fully configurable callback for advanced scenarios.
+ /// Use this overload when you need to: select keys by prefix, filter by labels, configure dynamic refresh, use feature flags, resolve Key Vault references, etc.
///
/// The configuration builder to add key-values to.
/// A callback used to configure Azure App Configuration options.