Modifica dei file di configurazione ASP.NET
Aggiornamento: novembre 2007
I dati di configurazione ASP.NET vengono memorizzati in file di testo XML, denominati Web.config, che possono essere presenti in più directory delle applicazioni ASP.NET. Ogni file Web.config applica le impostazioni di configurazione nella propria directory e in tutte le relative directory figlio. È possibile definire le impostazioni delle directory figlio in modo che eseguano l'override e la modifica delle impostazioni specificate nelle directory padre. L'elemento radice della gerarchia di configurazione di ASP.NET è il file systemroot\Microsoft.NET\Framework\NumeroVersione\CONFIG\Web.config, nel quale sono incluse le impostazioni relative a tutte le applicazioni ASP.NET che eseguono una versione specifica di Microsoft .NET Framework. Poiché ogni applicazione ASP.NET eredita le impostazioni di configurazione predefinite dal file Web.config principale, è necessario solo creare file Web.config per le impostazioni che eseguono l'override delle impostazioni predefinite.
Struttura dei file di configurazione
Ogni file di configurazione contiene tag e sottotag XML nidificati con attributi che specificano le impostazioni di configurazione. Tutte le informazioni di configurazione si trovano tra i tag XML principali <configuration> e </configuration>. All'interno di questi tag le informazioni di configurazione sono raggruppate in due aree principali: l'area di dichiarazione del gestore della sezione di configurazione e l'area delle impostazioni della sezione di configurazione. Per ulteriori informazioni, vedere Struttura dei file di configurazione ASP.NET (Sezioni e gestori della sezione).
Modifica delle impostazioni di configurazione
Poiché si tratta di file XML non crittografati, è possibile creare o modificare impostazioni di configurazione nei seguenti modi:
Mediante l'utilizzo dell'API di configurazione ASP.NET. Per ulteriori informazioni, vedere API di configurazione di ASP.NET.
Mediante l'utilizzo dello snap-in MMC ASP.NET.
Mediante lo Strumento di amministrazione sito Web per siti Web e applicazioni ASP.NET. Per ulteriori informazioni, vedere Strumento Amministrazione sito Web di ASP.NET.
Per modificare direttamente i file di configurazione, è possibile utilizzare un editor di testo o un editor XML. Per una sintassi appropriata, vedere gli argomenti di riferimento sulla configurazione in Impostazioni di configurazione di ASP.NET e Impostazioni di configurazione generali (ASP.NET).
Distinzione fra maiuscole e minuscole
Poiché i tag devono avere un formato XML corretto, per i tag, i sottotag e gli attributi viene effettuata la distinzione tra maiuscole e minuscole. I nomi di tag e di attributi sono caratterizzati da sequenze di lettere minuscole e maiuscole di tipo camel, ovvero il primo carattere di un nome di tag è minuscolo e la prima lettera di tutte le parole successive concatenate è maiuscola. Nella maggior parte dei casi, i valori di attributo stringa sono caratterizzati da sequenze di lettere minuscole e maiuscole di tipo Pascal, ovvero il primo carattere è maiuscolo e la prima lettera di tutte le parole successive concatenate è maiuscola. Le eccezioni sono true e false e sono sempre minuscole.
Sezioni personalizzate
L'infrastruttura di configurazione ASP.NET non fa distinzione tra i tipi dei dati di configurazione supportati dall'infrastruttura. Le classi dei gestori della sezione di configurazione elaborano tutti i dati Web.config. È possibile utilizzare i gestori della sezione di configurazione predefiniti disponibili con .NET Framework oppure creare i propri gestori per elaborare dati di configurazione personalizzati.
Per ulteriori informazioni sulla creazione di tipi di configurazione personalizzati, vedere Procedura: creare sezioni di configurazione personalizzate tramite ConfigurationSection.
Modifica dei file di configurazione remota
L'API di configurazione ASP.NET consente all'applicazione di modificare i file di configurazione di un computer remoto. In particolare è possibile modificare il file Machine.config o un file Web.config in tutte le applicazioni Microsoft Internet Information Services (IIS), o nelle relative directory figlio, presenti in un computer remoto. Se il file Web.config non esiste, i dati di configurazione restituiti saranno interamente costituiti dalle impostazioni ereditate che si applicano al percorso specificato. Se l'applicazione richiede un aggiornamento dei dati di configurazione restituiti, verrà creato un nuovo file. Per ulteriori informazioni, vedere Modifica dei file di configurazione remota ASP.NET e Procedura: accedere e modificare i file di configurazione ASP.NET in remoto.
Riavvio del dominio applicazione causato dalle modifiche della configurazione
L'apporto di modifiche alle impostazioni di configurazione nei file Web.config causa indirettamente il riavvio del dominio applicazione. Questo comportamento è stato definito in fase di progettazione. Facoltativamente, è possibile utilizzare l'attributo configSource per fare riferimento ai file di configurazione esterni, che non determinano il riavvio quando viene apportata una modifica. Per ulteriori informazioni, vedere configSource in Attributi generali ereditati da elementi di sezioni.
I tentativi di modifica di un file di configurazione da parte di un utente che non dispone dell'autorizzazione necessaria non determinano il riavvio del dominio applicazione.
Per ulteriori informazioni, vedere Gestione delle modifiche alle impostazioni di configurazione.
Vedere anche
Attività
Procedura: accedere e modificare i file di configurazione ASP.NET in remoto
Procedura: creare sezioni di configurazione personalizzate tramite ConfigurationSection
Concetti
Protezione della configurazione di ASP.NET
Modifica dei file di configurazione remota ASP.NET
Gestione delle modifiche alle impostazioni di configurazione