Procedura: creare file Web.config

Articolo
10/22/2014

Aggiornamento: novembre 2007

In ASP.NET viene utilizzata una gerarchia di file di testo XML, ognuno denominato Web.config, per archiviare le impostazioni che controllano la modalità di utilizzo del sito Web. L'utilizzo delle funzionalità del sistema di configurazione ASP.NET consente di configurare un intero server, un'applicazione ASP.NET o singole pagine. In questo argomento viene descritta la modalità di creazione di un file Web.config in Visual Web Developer.

Per creare un file Web.config

Fare clic sull'icona Aggiorna in Esplora soluzioni per accertarsi che un file Web.config non esista già nell'applicazione.

Se è già stato utilizzato lo Strumento di amministrazione sito Web o qualche altro mezzo per configurare l'applicazione, un file Web.config potrebbe essere stato creato automaticamente. Scegliendo Aggiorna viene aggiornato l'elenco di file.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del sito Web e quindi scegliere Aggiungi nuovo elemento.
Scegliere File di configurazione Web nella finestra Modelli.

Il nome del file nella casella di testo Nome deve essere Web.config. È possibile fornire al file un altro nome, ma questo è quello predefinito. Il download dell'estensione del nome del file .config è protetto da ASP.NET.
Fare clic su Aggiungi per creare il file e aprirlo per la modifica.

Nel file è contenuto il codice illustrato nella sezione "Esempio" più avanti in questo argomento, con alcuni valori predefiniti iniziali. L'applicazione eredita tutte le impostazioni di configurazione dai file Machine.config e Web.config nella directory %SystemRoot%\Microsoft.NET\Framework\<version>\CONFIG, ma tali impostazioni non verranno illustrate nel presente argomento. I file Web.config a livello di applicazione o a livello di directory devono essere creati solo se si desidera eseguire l'override delle impostazioni predefinite ereditate o aggiungere agli elementi di raccolta quali Elemento httpHandlers (schema delle impostazioni ASP.NET).

Per visualizzare tutte le impostazioni di configurazione dell'applicazione corrente, è possibile eseguire il codice incluso nell'argomento Procedura: visualizzare le impostazioni di configurazione ereditate e locali a livello di codice. In alternativa, è possibile visualizzare i file Machine.config.comments o Web.config.comments, che contengono anche commenti utili, nella directory %SystemRoot%\Microsoft.NET\Framework\<version>\CONFIG, ma questi due file non comprenderanno tutte le impostazioni di runtime Procedura: visualizzare le impostazioni di configurazione ereditate e locali a livello di codice.
Se il file Web.config è stato modificato, salvarlo.

Il salvataggio di un file Web.config consente il riavvio dell'applicazione. In alternativa è possibile utilizzare l'attributo configSource dei singoli elementi della sezione per scegliere un file di configurazione secondario che non determini il riavvio di un'applicazione una volta modificata. Per ulteriori informazioni, vedere configSource in Attributi generali ereditati da elementi di sezioni.

Per utilizzare IntelliSense per la modifica delle impostazioni di configurazione

Aprire il file Web.config in Visual Web Developer.
Nella finestra di modifica, posizionare il cursore all'interno dei tag <system.web> </system.web> in una riga a parte, ma non all'interno degli altri tag.
Digitare il carattere minore di (<) per iniziare un elemento nuovo.

Viene visualizzato un elenco a discesa che offre gli elementi validi da aggiungere in corrispondenza del punto di inserimento. In alternativa, è possibile premere Ctrl+J per visualizzare l'elenco a discesa senza digitare il carattere minore di.
Selezionare anonymousIdentification.

L'elemento Elemento anonymousIdentification (schema delle impostazioni ASP.NET) viene inserito nel file Web.config e viene chiuso. Se un elemento viene terminato con un tag di chiusura, esistono elementi figlio disponibili che si possono impostare. Se un elemento viene terminato, quale l'elemento anonymousIdentification riportato di seguito, non esiste alcun elemento figlio disponibile da impostare.
```
<anonymousIdentification />
```
Inserire il cursore all'interno del tag <anonymousIdentification /> e premere la BARRA SPAZIATRICE.

Viene visualizzato un elenco a discesa che offre gli attributi validi da aggiungere all'elemento anonymousIdentification. In alternativa, è possibile premere Ctrl+J per visualizzare l'elenco a discesa senza premere la BARRA SPAZIATRICE.
Selezionare enabled.

L'attributo enabled viene inserito nel file Web.config e, poiché può trattarsi di un attributo booleano, in un elenco a discesa vengono forniti i valori true e false.
Selezionare false. Questa è l'impostazione predefinita del sistema.

Nel sistema IntelliSense vengono forniti suggerimenti per gli elementi e attributi che sono disponibili in corrispondenza del punto di inserimento. Talvolta non sono forniti attributi specializzati. Quando si configura ad esempio un elemento providers, come per l'elemento Elemento siteMap (schema delle impostazioni ASP.NET), sono disponibili attributi differenti in base al tipo di provider che si sta aggiungendo. In IntelliSense non sono visualizzati questi attribuiti in quando dipendono dal valore dell'attributo type.
Modificare il valore dell'attributo enabled in "falsex", vale a dire un valore non valido.

Nel sistema IntelliSense viene fornito il controllo di convalida e viene visualizzata una linea ondulata sotto il testo non convalidato.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato il contenuto iniziale di un file Web.config creato mediante Visual Web Developer. Sono fornite le impostazioni predefinite per gli elementi compilation e authentication. Per attivare il debug ASP.NET, modificare l'attributo debug dell'elemento compilation in true. Tutti gli elementi visualizzabili all'interno dell'elemento system.web sono documentati in Impostazioni di configurazione di ASP.NET.

<?xml version="1.0"?>
<!-- 
    Note: As an alternative to hand editing this file you can use the 
    Web Site Administration Tool to configure settings for your application. Use
    the Web site->Asp.Net Configuration option in Visual Studio.
    A full list of settings and comments can be found in 
    machine.config.comments usually located in 
    \Windows\Microsoft.Net\Framework\v2.x\Config 
-->
<configuration xmlns="https://schemas.microsoft.com/.NetConfiguration/v2.0">
    <appSettings/>
    <connectionStrings/>
    <system.web>
        <!-- 
            Set compilation debug="true" to insert debugging 
            symbols into the compiled page. Because this 
            affects performance, set this value to true only 
            during development.
        -->
        <compilation debug="false"/>
        <!--
            The <authentication> section enables configuration 
            of the security authentication mode used by 
            ASP.NET to identify an incoming user. 
        -->
        <authentication mode="Windows"/>
        <!--
            The <customErrors> section enables configuration 
            of what to do if/when an unhandled error occurs 
            during the execution of a request. Specifically, 
            it enables developers to configure html error pages 
            to be displayed in place of a error stack trace.

        <customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
            <error statusCode="403" redirect="NoAccess.htm"/>
            <error statusCode="404" redirect="FileNotFound.htm"/>
        </customErrors>
        -->
    </system.web>
</configuration>

Sicurezza

Quando vengono memorizzate informazioni riservate in un file di configurazione relativo a un'applicazione, i valori riservati devono essere crittografati utilizzando la configurazione protetta. Per ulteriori informazioni su questa operazione e altri problemi di protezione dei file di configurazione, vedere Protezione della configurazione di ASP.NET.