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

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 suscripción a Azure: cree una cuenta gratuita
• Visual Studio
• .NET Framework 4.7.2 o una versión posterior

Creación de un almacén de App Configuration

1. Para crear un almacén de App Configuration, inicie sesión en Azure Portal. En la esquina superior izquierda de la página principal, seleccione Crear un recurso. En el cuadro Buscar en Marketplace, escriba App Configuration y presione Entrar.

   

2. Seleccione Configuración de la aplicación en los resultados de la búsqueda y, después, Crear.

   

3. En el panel Crear de App Configuration, introduzca la siguiente configuración:

   Configuración	Valor sugerido	Descripción
   Suscripción	Su suscripción	Seleccione la suscripción de Azure que desee usar para probar App Configuration. Si su cuenta solo tiene una suscripción, se selecciona automáticamente y la lista Suscripción no aparece.
   Grupos de recursos	AppConfigTestResources	Seleccione o cree un grupo de recursos para el recurso del almacén de App Configuration. Este grupo es útil para organizar los distintos recursos que quiera eliminar al mismo tiempo mediante la eliminación del grupo de recursos. Para más información, consulte Administración de los recursos de Azure a través del Portal.
   Nombre del recurso	Nombre único globalmente	Escriba un nombre de recurso único para usarlo como recurso de almacén de App Configuration. El nombre debe ser una cadena de entre 5 y 50 caracteres y solo puede contener números, letras y el carácter -. El nombre no puede comenzar ni terminar con el carácter -.
   Ubicación	Centro de EE. UU.	Use Ubicación para especificar la ubicación geográfica en la que se hospeda el almacén de App Configuration. Para optimizar el rendimiento, cree el recurso en la misma región que los demás componentes de la aplicación.
   Plan de tarifa	Gratis	Seleccione el plan de tarifa deseado. Para más información, consulte la página de precios de App Configuration.

4. Seleccione Revisar y crear para validar la configuración.

5. Seleccione Crear. La implementación puede tardar unos minutos.

6. Una vez finalizada la implementación, vaya al recurso de App Configuration. Seleccione Configuración > Claves de acceso. Tome nota de la cadena de conexión de la clave de solo lectura principal. Usará esta cadena de conexión más adelante para configurar la aplicación y que se comunique con el almacén de Azure App Configuration que ha creado.

7. Seleccione Explorador de configuración > + Crear > Clave-valor para agregar los siguientes clave-valor:

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

   Deje Etiqueta y Tipo de contenido vacíos.

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

1. 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

2. 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.

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 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"
   

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 desea seguir usando los recursos creados en este artículo, elimine el grupo de recursos que creó aquí para evitar cargos.

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.