Condividi tramite


Configurare le app usando i file di configurazione

Nota

Questo articolo è specifico di .NET Framework. Non si applica alle implementazioni più recenti di .NET, incluse .NET 6 e versioni successive.

.NET Framework offre agli sviluppatori e agli amministratori il controllo e la flessibilità del modo in cui le applicazioni vengono eseguite tramite i file di configurazione . I file di configurazione sono file XML che possono essere modificati in base alle esigenze. Un amministratore può controllare le risorse protette a cui un'applicazione può accedere, quali versioni degli assembly verranno usate da un'applicazione e dove si trovano applicazioni e oggetti remoti. Gli sviluppatori possono inserire le impostazioni nei file di configurazione, eliminando la necessità di ricompilare un'applicazione ogni volta che viene modificata un'impostazione. Questa sezione descrive cosa può essere configurato e perché la configurazione di un'applicazione potrebbe essere utile.

Nota

Il codice gestito può usare le classi nello spazio dei nomi System.Configuration per leggere le impostazioni dai file di configurazione, ma non scrivere impostazioni in tali file.

Questo articolo descrive la sintassi dei file di configurazione e fornisce informazioni sui tre tipi di file di configurazione: computer, applicazione e sicurezza.

Formato del file di configurazione

I file di configurazione contengono elementi, ovvero strutture di dati logiche che impostano le informazioni di configurazione. All'interno di un file di configurazione si usano tag per contrassegnare l'inizio e la fine di un elemento. Ad esempio, l'elemento <runtime> è costituito da <runtime>elementi figli</runtime>. Un elemento vuoto viene scritto come <runtime/> o <runtime></runtime>.

Come per tutti i file XML, la sintassi nei file di configurazione fa distinzione tra maiuscole e minuscole.

È possibile specificare le impostazioni di configurazione usando attributi predefiniti, ovvero coppie nome/valore all'interno del tag iniziale di un elemento. Nell'esempio seguente vengono specificati due attributi (version e href) per l'elemento <codeBase> , che specifica dove il runtime può individuare un assembly . Per altre informazioni, vedere Specifica del percorso di un assembly).

<codeBase version="2.0.0.0"
          href="http://www.litwareinc.com/myAssembly.dll"/>

File di configurazione del computer

Il file di configurazione del computer, Machine.config, contiene le impostazioni applicabili a un intero computer. Questo file si trova nel percorso di installazione di %runtime%\Config directory. Machine.config contiene le impostazioni di configurazione per l'associazione di assembly di sistema, i canali di comunicazione remoti predefiniti e ASP.NET.

Innanzitutto, il sistema di configurazione cerca nel file di configurazione della macchina l'elemento <appSettings> e altre sezioni di configurazione che uno sviluppatore potrebbe definire. Quindi, viene cercato nel file di configurazione dell'applicazione. Per mantenere gestibile il file di configurazione del computer, è consigliabile inserire queste impostazioni nel file di configurazione dell'applicazione. Tuttavia, l'inserimento delle impostazioni nel file di configurazione del computer può rendere il sistema più gestibile. Ad esempio, se si dispone di un componente di terze parti usato sia dall'applicazione client che dall'applicazione server, è più semplice inserire le impostazioni per tale componente in un'unica posizione. In questo caso, il file di configurazione del computer è la posizione appropriata per le impostazioni, quindi non si hanno le stesse impostazioni in due file diversi.

Nota

La distribuzione di un'applicazione tramite XCOPY non copia le impostazioni nel file di configurazione del computer.

Per altre informazioni su come Common Language Runtime usa il file di configurazione del computer per l'associazione di assembly, vedere Come il runtime individua gli assembly.

File di configurazione dell'applicazione

Un file di configurazione dell'applicazione contiene impostazioni specifiche di un'app. Questo file include impostazioni di configurazione lette da Common Language Runtime (ad esempio criteri di associazione di assembly, oggetti remoti e così via) e impostazioni che l'app può leggere.

Il nome e il percorso del file di configurazione dell'applicazione dipendono dall'host dell'app, che può essere uno dei seguenti:

  • App ospitata in formato eseguibile.

    Queste app hanno due file di configurazione: un file di configurazione di origine, che viene modificato dallo sviluppatore durante lo sviluppo e un file di output distribuito con l'app.

    Per impostazione predefinita, il nome del file di configurazione di origine è App.config. Quando si crea un progetto .NET Framework in Visual Studio, al progetto viene aggiunto automaticamente un file App.config. È anche possibile aggiungere manualmente un file selezionando File>Nuovo file. Posizionare il file App.config nella directory del progetto e impostarne la proprietà Copia nella directory di output su Copia sempre o Copia se più recente.

    Per creare il file di configurazione di output distribuito con l'app, Visual Studio copia il file di configurazione di origine nella directory in cui viene inserito l'assembly compilato. Questo file è denominato <nomeapp>.exe.config. Ad esempio, un'app denominata myApp.exe ha un file di configurazione di output denominato myApp.exe.config.

    In alcuni casi, Visual Studio potrebbe modificare il file di configurazione di output. Per altre informazioni, vedere Reindirizzare le versioni a livello di app.

  • App ospitata su ASP.NET.

    Per altre informazioni sui file di configurazione di ASP.NET, vedere ASP.NET Impostazioni di configurazione.

File di configurazione della sicurezza

I file di configurazione della sicurezza contengono informazioni sulla gerarchia del gruppo di codice e sui set di autorizzazioni associati a un livello di criteri. Raccomandiamo fortemente di utilizzare lo strumento Criteri di accesso al codice di protezione (Caspol.exe) per modificare i criteri di sicurezza, assicurandovi che le modifiche ai criteri non corrompano i file di configurazione della sicurezza.

Nota

A partire da .NET Framework 4, i file di configurazione della sicurezza sono presenti solo se i criteri di sicurezza sono stati modificati.

I file di configurazione della sicurezza si trovano nei percorsi seguenti:

  • File di configurazione dei criteri aziendali: %runtime-install-path%\Config\Enterprisesec.config

  • File di configurazione dei criteri del sistema: %percorso-di-installazione-runtime%\Config\Security.config

  • File di configurazione dei criteri utente: %USERPROFILE%\Application data\Microsoft\CLR security config\vxx.xx\Security.config

Vedere anche