Condividi tramite

Guida introduttiva: Creare un'app .NET Framework con app Azure Configurazione

  • Articolo

Esistono due modi per incorporare app Azure Configuration 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 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 Web Forms ASP.NET/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. Premere Avanti.

  3. In Configura il nuovo progetto immettere un nome di progetto. In Framework selezionare .NET Framework 4.7.2 o versione successiva. Premere Crea.

Connettersi a un archivio di Configurazione app

Connettersi al negozio Configurazione app usando Microsoft Entra ID (scelta consigliata) o un 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 indicato di seguito. È possibile connettersi al negozio Configurazione app usando Microsoft Entra ID (scelta consigliata) o un stringa di connessione.

    Viene DefaultAzureCredential usato per eseguire l'autenticazione nell'archivio Configurazione app per impostazione predefinita. Seguire le istruzioni per assegnare le credenziali al ruolo lettore dati 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 Configurazione app viene letto dalla variabile Endpointdi ambiente . È anche possibile aggiungere il Environment generatore di configurazione prima MyConfigStore di nella configBuilders proprietà della appSettings sezione .

  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 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 Configurazione app output 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