Condividi tramite

Avvio rapido: Creare un'app .NET Framework con Configurazione app di Azure

Esistono due modi per incorporare Configurazione app di Azure in un'app basata su .NET Framework.

  • Il generatore di configurazione per Configurazione app consente il caricamento dei dati da Configurazione app in Impostazioni app. L'app accede alla configurazione come sempre tramite ConfigurationManager. Non è necessario apportare modifiche al codice diverse da aggiornamenti ai file app.config o web.config. Questa guida introduttiva illustra questa opzione.
  • Come è progettato da .NET Framework, le impostazioni dell'app possono essere aggiornate solo al riavvio dell'applicazione. Il provider .NET di Configurazione app è una libreria .NET Standard. Supporta la memorizzazione nella cache e l'aggiornamento della configurazione in modo dinamico senza il riavvio dell'applicazione. Se la configurazione dinamica è essenziale per l'utente e si è disposti a apportare modifiche al codice, vedere le esercitazioni su come implementare gli aggiornamenti della configurazione dinamica in un'app console .NET Framework o in un'app Web ASP.NET.

In questa guida introduttiva viene usata un'app console .NET Framework come esempio, ma la stessa tecnica si applica a un'app ASP.NET Web Forms/MVC.

Prerequisiti

Aggiungere un valore chiave

Aggiungere il valore chiave seguente all’archivio di Configurazione app e lasciare Etichetta e Tipo di contenuto con i valori predefiniti. Per altre informazioni su come aggiungere valori chiave a un archivio usando il portale di Azure o l’interfaccia della riga di comando, andare a Creare un valore chiave.

Chiave valore
TestApp:Settings:Message Dati di Configurazione app di Azure

Creare un'app console .NET Framework

  1. Avviare Visual Studio e selezionare Crea un nuovo progetto.

  2. In Crea un nuovo progetto, filtrare in base al tipo di progetto Console e selezionare App console (.NET Framework) con C# dall'elenco dei modelli di progetto. Scegliere Avanti.

  3. In Configura il nuovo progetto immettere un nome di progetto. In Framework, selezionare .NET Framework 4.7.2 o versione successiva. Fare clic su Crea.

Connettersi a un archivio di Configurazione app

Connettersi all'archivio di Configurazione app usando Microsoft Entra ID (scelta consigliata) o una stringa di connessione.

  1. Fare clic con il pulsante destro del mouse sul progetto e scegliere Gestisci pacchetti NuGet. Nella scheda Sfoglia, cercare e aggiungere le versioni stabili più recenti dei pacchetti NuGet seguenti al progetto.

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

  2. Aggiornare il file App.config del progetto come segue. È possibile connettersi all'archivio di Configurazione app usando Microsoft Entra ID (scelta consigliata) o una stringa di connessione.

    DefaultAzureCredential viene usato per eseguire l'autenticazione nell'archivio di Configurazione app per impostazione predefinita. Seguire le istruzioni per assegnare le credenziali al ruolo Lettore dati di Configurazione app. Assicurarsi di consentire tempo sufficiente per la propagazione dell'autorizzazione prima di eseguire l'applicazione.

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

    Il valore dell'endpoint dell'archivio di Configurazione app viene letto dalla variabile di ambiente Endpoint. È anche possibile aggiungere il generatore di configurazione Environment prima di MyConfigStore nella proprietà configBuilders della sezione appSettings.

  3. Aprire il file Program.cs e aggiornare il metodo Main per usare Configurazione app effettuando una chiamata a ConfigurationManager.

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

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

Compilare ed eseguire l'app

  1. Impostare una variabile di ambiente.

    Impostare una variabile di ambiente denominata Endpoint sull'endpoint dell'archivio di Configurazione app disponibile in Panoramica dell'archivio nel portale di Azure.

    Se si usa il prompt dei comandi di Windows, eseguire il comando seguente e riavviare il prompt per rendere effettiva la modifica:

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

    Se si usa PowerShell, eseguire il comando seguente:

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

    Se si usa macOS o Linux, eseguire il comando seguente:

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

  2. Riavviare Visual Studio per rendere effettiva la modifica.

  3. Premere CTRL+F5 per compilare ed eseguire l'app console. Verrà visualizzato il messaggio degli output di Configurazione app nella console.

Pulire le risorse

Se non si vuole continuare a usare le risorse create in questo articolo, eliminare il gruppo di risorse creato qui per evitare addebiti.

Importante

L'eliminazione di un gruppo di risorse è irreversibile. Il gruppo di risorse e tutte le risorse in esso contenute vengono eliminati in modo permanente. Assicurarsi di non eliminare accidentalmente il gruppo di risorse o le risorse sbagliate. Se le risorse per questo articolo sono state create in un gruppo di risorse che contiene altre risorse che si vogliono mantenere, eliminare ogni risorsa singolarmente dal rispettivo riquadro anziché eliminare il gruppo di risorse.

  1. Accedere al portale di Azure e selezionare Gruppi di risorse.
  2. Nella casella Filtra per nome immettere il nome del gruppo di risorse.
  3. Nell'elenco dei risultati selezionare il nome del gruppo di risorse per visualizzare una panoramica.
  4. Selezionare Elimina gruppo di risorse.
  5. Verrà chiesto di confermare l'eliminazione del gruppo di risorse. Immettere il nome del gruppo di risorse per confermare e selezionare Elimina.

Dopo qualche istante, il gruppo di risorse e tutte le risorse che contiene vengono eliminati.

Passaggi successivi

In questa guida di avvio rapido è stato creato un nuovo archivio di Configurazione app, che è stato usato con un'app console .NET Framework. Per informazioni su come abilitare l'app .NET Framework per aggiornare dinamicamente le impostazioni di configurazione, continuare con le esercitazioni successive.

Abilitare la configurazione dinamica in un'app .NET Framework

Abilitare la configurazione dinamica in un'app Web ASP.NET

  • Last updated on