Add AddAzureAppConfiguration overload to take endpoint and entra id (#694)

* add overload to take endpoint and credential

* enrich comment for intellisense

* update comment to point to use options.connect pattern

* update

Author: zhiyuanliang-ms

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()
         }
 
         /// <summary>
-        /// 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 <see cref="Action{AzureAppConfigurationOptions}"/> parameter with options.Connect().
         /// </summary>
         /// <param name="configurationBuilder">The configuration builder to add key-values to.</param>
         /// <param name="connectionString">The connection string used to connect to the configuration store.</param>
@@ -47,7 +51,10 @@ public static IConfigurationBuilder AddAzureAppConfiguration(
         }
 
         /// <summary>
-        /// 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 <see cref="Action{AzureAppConfigurationOptions}"/> parameter with options.Connect().
         /// </summary>
         /// <param name="configurationBuilder">The configuration builder to add key-values to.</param>
         /// <param name="connectionStrings">The list of connection strings used to connect to the configuration store and its replicas.</param>
@@ -64,7 +71,30 @@ public static IConfigurationBuilder AddAzureAppConfiguration(
         }
 
         /// <summary>
-        /// 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 <see cref="Action{AzureAppConfigurationOptions}"/> parameter with options.Connect().
+        /// </summary>
+        /// <param name="configurationBuilder">The configuration builder to add key-values to.</param>
+        /// <param name="endpoint">The endpoint used to connect to the configuration store.</param>
+        /// <param name="credential">The token credential used to authenticate requests to the configuration store.</param>
+        /// <param name="optional">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.
+        /// <exception cref="ArgumentException"/> will always be thrown when the caller gives an invalid input configuration (connection strings, endpoints, key/label filters...etc).
+        /// </param>
+        /// <returns>The provided configuration builder.</returns>
+        public static IConfigurationBuilder AddAzureAppConfiguration(
+            this IConfigurationBuilder configurationBuilder,
+            Uri endpoint,
+            TokenCredential credential,
+            bool optional = false)
+        {
+            return configurationBuilder.AddAzureAppConfiguration(options => options.Connect(endpoint, credential), optional);
+        }
+
+        /// <summary>
+        /// Adds key-value data from an Azure App Configuration store to a configuration builder using a fully configurable <see cref="AzureAppConfigurationOptions"/> 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.
         /// </summary>
         /// <param name="configurationBuilder">The configuration builder to add key-values to.</param>
         /// <param name="action">A callback used to configure Azure App Configuration options.</param>