Compartir a través de

Inicio rápido: Creación de una aplicación de .NET Framework con Azure App Configuration

  • Artículo

Hay dos maneras de incorporar Azure App Configuration en una aplicación basada en .NET Framework.

  • El generador de configuración para App Configuration permite que los datos de App Configuration se carguen en Configuración de aplicaciones. La aplicación accede a la configuración como siempre lo hace a través de ConfigurationManager. No es necesario realizar ningún cambio de código que no sean las actualizaciones de los archivos de app.config o web.config. Este inicio rápido le guía a través de esta opción.
  • Tal y como está diseñado en .NET Framework, la configuración de la aplicación solo se puede actualizar tras el reinicio de la aplicación. El proveedor .NET de App Configuration es una biblioteca .NET Standard. Admite el almacenamiento en caché y la actualización dinámica de la configuración sin reiniciar la aplicación. Si la configuración dinámica es esencial para usted y no le importa realizar cambios en el código, consulte los tutoriales sobre cómo implementar actualizaciones de configuración dinámica en una aplicación de consola de .NET Framework o en una aplicación web de ASP.NET.

En este inicio rápido, se usa una aplicación de consola .NET Framework como ejemplo, pero la misma técnica se usa para una aplicación ASP.NET Web Forms o MVC.

Prerrequisitos

Agregar un par clave-valor

Agregue el siguiente par clave-valor al almacén de App Configuration y deje Etiqueta y Tipo de contenido con sus valores predeterminados. Para obtener más información sobre cómo agregar pares clave-valor a un almacén mediante Azure Portal o la CLI, vaya a Creación de un par clave-valor.

Clave Value
TestApp:Settings:Message Datos de Azure App Configuration

Creación de una aplicación de consola de .NET Framework

  1. Inicie Visual Studio y seleccione Crear un proyecto.

  2. En Crear un proyecto, filtre por el tipo de proyecto Consola y seleccione Aplicación de consola (.NET Framework) con C# de la lista de plantillas de proyecto. Presione Siguiente.

  3. En Configurar el nuevo proyecto, asígnele al proyecto un nombre. En Marco, seleccione .NET Framework 4.7.2 o una versión posterior. Pulse Crear.

Conexión a un almacén de App Configuration

Puede conectarse al almacén de App Configuration mediante Microsoft Entra ID (recomendado) o una cadena de conexión.

  1. Haga clic con el botón derecho en el proyecto y seleccione Administrar paquetes NuGet. En la pestaña Examinar, busque y agregue las versiones estables más recientes de los siguientes paquetes NuGet al proyecto.

    • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration
    • Microsoft.Configuration.ConfigurationBuilders.Environment
    • System.Configuration.ConfigurationManager

  2. Actualice el archivo App.config del proyecto como se indica a continuación. Puede conectarse al almacén de App Configuration mediante Microsoft Entra ID (recomendado) o una cadena de conexión.

    Se usa DefaultAzureCredential para autenticarse en el almacén de App Configuration de forma predeterminada. Siga las instrucciones para asignar la credencial al rol Lector de datos de App Configuration. Asegúrese de dejar tiempo suficiente para que el permiso se propague antes de ejecutar la aplicación.

    <configSections>
    <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false" />
</configSections>

<configBuilders>
    <builders>
        <add name="MyConfigStore" mode="Greedy" endpoint="${Endpoint}" type="Microsoft.Configuration.ConfigurationBuilders.AzureAppConfigurationBuilder, Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration" />
        <add name="Environment" mode="Greedy" type="Microsoft.Configuration.ConfigurationBuilders.EnvironmentConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.Environment" />
    </builders>
</configBuilders>

<appSettings configBuilders="Environment,MyConfigStore">
    <add key="AppName" value="Console App Demo" />
    <add key="Endpoint" value ="Set via an environment variable - for example, dev, test, staging, or production endpoint." />
</appSettings>

    El valor de punto de conexión del almacén de App Configuration se lee de la variable de entorno Endpoint. También agregará el generador de configuración de Environment antes del MyConfigStore en la propiedad configBuilders de la sección appSettings.

  3. Abra Program.cs y actualice el método Main para usar App Configuration mediante una llamada a ConfigurationManager.

    static void Main(string[] args)
{
    string message = System.Configuration.ConfigurationManager.AppSettings["TestApp:Settings:Message"];

    Console.WriteLine(message);
    Console.ReadKey();
}

Compilación y ejecución de la aplicación

  1. Establezca una variable de entorno.

    Establezca una variable de entorno denominada Punto de conexión en el punto de conexión del almacén de App Configuration que se encuentra en la Información general del almacén en Azure Portal.

    Si usa el símbolo del sistema de Windows, ejecute el siguiente comando y reinícielo para que se aplique el cambio:

    setx Endpoint "<endpoint-of-your-app-configuration-store>"

    Si usa PowerShell, ejecute el siguiente comando:

    $Env:Endpoint = "<endpoint-of-your-app-configuration-store>"

    Si usa macOS o Linux, ejecute el siguiente comando:

    export Endpoint='<endpoint-of-your-app-configuration-store>'

  2. Reinicie Visual Studio para permitir que el cambio surta efecto.

  3. Presione Ctrl + F5 para compilar y ejecutar la aplicación de consola. Debería ver el mensaje de las salidas de App Configuration en la consola.

Limpieza de recursos

Si no quiere seguir usando los recursos que se han creado en este artículo, elimine el grupo de recursos que creó aquí para evitar cargos.

Importante

La eliminación de un grupo de recursos es irreversible. El grupo de recursos y todos los recursos que contiene se eliminan permanentemente. Asegúrese de que no elimina por accidente el grupo de recursos o los recursos equivocados. Si creó los recursos para este artículo en un grupo de recursos que contenga los recursos que desee conservar, elimine cada recurso de forma individual desde su panel respectivo, en lugar de eliminar el grupo de recursos.

  1. Inicie sesión en Azure Portal y después seleccione Grupos de recursos.
  2. En el cuadro de texto Filtrar por nombre, escriba el nombre del grupo de recursos.
  3. En la lista resultados, seleccione el nombre del grupo de recursos para ver la información general.
  4. Seleccione Eliminar grupo de recursos.
  5. Se le pedirá que confirme la eliminación del grupo de recursos. Escriba el nombre del grupo de recursos para confirmar y seleccione Eliminar.

Transcurridos unos instantes, el grupo de recursos y todos sus recursos se eliminan.

Pasos siguientes

En este inicio rápido, ha creado un almacén de App Configuration y lo ha usado con una aplicación de consola de .NET Framework. Para aprender a habilitar la aplicación de .NET Framework para actualizar dinámicamente la configuración, vaya a los siguientes tutoriales.

Habilitación de la configuración dinámica en una aplicación de .NET Framework

Habilitación de la configuración dinámica en la aplicación web de ASP.NET