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

Artículo
03/30/2023

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. Esta guía de inicio rápido le guiará 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 está dispuesto a 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

Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.
Un almacén de App Configuration. Crear un almacén.
Visual Studio
.NET Framework 4.7.2 o una versión posterior

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

Inicie Visual Studio y seleccione Crear un proyecto.
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.
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

Haga clic con el botón derecho en el proyecto y seleccione Administrar paquetes NuGet. En la pestaña Examinar, busque y agregue los siguientes paquetes NuGet al proyecto.
- Versión 1.0.0 o posterior de Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration
- Versión 2.0.0 o posterior de Microsoft.Configuration.ConfigurationBuilders.Environment
- Versión 4.6.0 o posterior de System.Configuration.ConfigurationManager

Actualice el archivo App.config del proyecto como sigue:

<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" connectionString="${ConnectionString}" 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="ConnectionString" value ="Set via an environment variable - for example, dev, test, staging, or production connection string." />
</appSettings>

La cadena de conexión del almacén de App Configuration se lee en la variable de entorno ConnectionString. Agregue el generador de configuración Environment antes de MyConfigStore en la propiedad configBuilders de la sección appSettings.

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

Establezca una variable de entorno llamada ConnectionString en la cadena de conexión de clave de solo lectura obtenida durante la creación del almacén de App Configuration.

Si usa el símbolo del sistema de Windows, ejecute el siguiente comando:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Si usa Windows PowerShell, ejecute el siguiente comando:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Reinicie Visual Studio para permitir que el cambio surta efecto.
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.

Inicie sesión en Azure Portal y después seleccione Grupos de recursos.
En el cuadro de texto Filtrar por nombre, escriba el nombre del grupo de recursos.
En la lista resultados, seleccione el nombre del grupo de recursos para ver la información general.
Seleccione Eliminar grupo de recursos.
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