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

Articolo
02/21/2024

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 App Impostazioni. 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, l'app Impostazioni può essere aggiornata 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

Un account Azure con una sottoscrizione attiva. Crearne una gratuitamente.
Archivio Configurazione app. Creare un archivio.
Visual Studio
.NET Framework 4.7.2 o versione successiva

Aggiungere un valore chiave

Aggiungere il valore chiave seguente all'archivio 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, vedere Creare un valore chiave.

Chiave	valore
TestApp:Impostazioni:Message	Dati della configurazione di app Azure

Creare un'app console .NET Framework

Avviare Visual Studio e selezionare Crea un nuovo progetto.
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.
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

Fare clic con il pulsante destro del mouse sul progetto e scegliere Gestisci pacchetti NuGet. Nella scheda Sfoglia cercare e aggiungere i pacchetti NuGet seguenti al progetto.
- Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration versione 1.0.0 o successiva
- Microsoft.Configuration.ConfigurationBuilders.Environment versione 2.0.0 o successiva
- System.Configuration.ConfigurationManager versione 4.6.0 o successiva

Aggiornare il file App.config del progetto come segue:

<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 stringa di connessione dell'archivio di Configurazione app viene letta dalla variabile di ambiente ConnectionString. Aggiungere il generatore di configurazione Environment prima di MyConfigStore nella proprietà configBuilders della sezione appSettings.

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

Impostare una variabile di ambiente denominata Connessione ionString sulla chiave di sola lettura stringa di connessione ottenuta durante la creazione dell'archivio Configurazione app.

Se si usa il prompt dei comandi di Windows, eseguire il comando seguente:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Se si usa Windows PowerShell, eseguire il comando seguente:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Riavviare Visual Studio per rendere effettiva la modifica.
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.

Accedere al portale di Azure e selezionare Gruppi di risorse.
Nella casella Filtra per nome immettere il nome del gruppo di risorse.
Nell'elenco dei risultati selezionare il nome del gruppo di risorse per visualizzare una panoramica.
Selezionare Elimina gruppo di risorse.
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