Condividi tramite

Modificare la configurazione di un'applicazione ASP.NET

Questo articolo descrive come modificare il file Web.config di un'applicazione ASP.NET.

Versione originale del prodotto: ASP.NET
Numero KB originale: 815178

Riepilogo

Il file Web.config definisce il comportamento delle applicazioni ASP.NET. Microsoft .NET Framework, incluso ASP.NET, usa file di testo con estensione config in formato XML per configurare le applicazioni. Si tratta di una partenza dai meccanismi di configurazione convenzionali del Registro di sistema e della metabase. Attualmente non è disponibile uno snap-in Microsoft Management Console (MMC) o un altro strumento di amministrazione fornito da Microsoft per la creazione e la modifica di file con estensione config.

Aggiungere le impostazioni di configurazione a Web.config

La maggior parte delle applicazioni ASP.NET include un file Web.config predefinito che può essere modificato con qualsiasi editor di testo, ad esempio Blocco note. In genere, i file Web.config contengono commenti che rendono autoesplicativo la modifica del file. Tuttavia, potrebbe essere necessario aggiungere elementi di configurazione a un file Web.config che non dispone già dell'elemento di configurazione definito. Per aggiungere un elemento di configurazione standard a un file Web.config , seguire questa procedura:

  1. Aprire il file Machine.config in un editor di testo, ad esempio Blocco note.

    Il file Machine.config si trova nella %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ directory .

  2. Nel file Machine.config individuare l'impostazione di configurazione di cui si vuole eseguire l'override nel file Web.config. Quando l'elemento è più di una riga, l'elemento inizia con una <element_name> riga e termina con </element_name>. L'elemento può anche essere auto-chiusura e può essere simile a <element_name attribute1='option' attribute2='option' />. Lo spazio vuoto viene ignorato. Pertanto, l'elemento può estendersi su più righe. L'elemento può essere preceduto da un commento. Il commento è contenuto all'interno <!-- and --> dei contrassegni. L'esempio <trace> di elemento di configurazione seguente è un esempio di elemento di chiusura automatica. L'esempio di <trace> elemento di configurazione ha più attributi, si estende su più righe e ha un commento all'inizio.

    <!--
trace Attributes:
    enabled="[true|false]" - Enable application tracing
    localOnly="[true|false]" - View trace results from localhost only
    pageOutput="[true|false]" - Display trace output on individual pages
    requestLimit="[number]" - Number of trace results available in trace.axd
    traceMode="[SortByTime|SortByCategory]" - Sorts trace result displays based on Time or Category
 -->
<trace
    enabled="false"
    localOnly="true"
    pageOutput="false"
    requestLimit="10"
    traceMode="SortByTime"
/>

  3. Copiare l'intero elemento di configurazione e qualsiasi commento iniziale negli Appunti.

  4. Determinare la modalità di annidamento dell'elemento nel file Machine.config .

    Il file Machine.config è gerarchico e gli elementi di configurazione sono annidati in altri elementi. Quando si copia un elemento di configurazione dal file Machine.config al file Web.config , è necessario annidare l'elemento di configurazione nello stesso elemento da cui è stato copiato. Per determinare l'elemento del file Machine.config in cui è contenuto l'elemento di configurazione, scorrere verso l'alto nel file Machine.config fino a trovare un elemento aperto, non chiuso. L'elemento contenitore è semplice da identificare perché gli elementi di livello superiore hanno un rientro minore.

    La maggior parte degli elementi di configurazione ASP.NET è contenuta nell'elemento <system.web> . La fine dell'elemento ( </system.web> ) deve essere posizionata dopo l'elemento di configurazione.

    Note

    Elemento in cui è contenuto l'elemento di configurazione. È necessario incollare l'elemento nello stesso elemento nel file Web.config . Un elemento di configurazione può essere annidato in più elementi. È necessario creare tutti gli elementi di livello superiore nel file Web.config .

  5. Chiudere il file Machine.config e quindi usare l'editor di testo per aprire il file Web.config nella directory radice dell'applicazione ASP.NET.

  6. Incollare l'elemento di configurazione tra l'inizio e la fine dell'elemento identificato nel passaggio 4.

    Ad esempio, se l'elemento di configurazione è contenuto nell'elemento <system.web> , l'elemento di configurazione deve essere incollato immediatamente dopo la riga di apertura dell'elemento <system.web> e prima della </system.web> riga di chiusura.

  7. Modificare l'elemento di configurazione nel file Web.config per eseguire l'override dell'impostazione Machine.config per tale applicazione.

    Questa impostazione si applica alla cartella che contiene il file Web.config e tutte le sottocartelle.

Riferimenti