Modificare la configurazione di un'applicazione ASP.NET

  • Articolo

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 .config in formato XML per configurare le applicazioni. Si tratta di un'uscita dai meccanismi di configurazione convenzionali del Registro di sistema e della metabase. Attualmente non è disponibile alcun snap-in di Microsoft Management Console (MMC) o altro strumento di amministrazione fornito da Microsoft per la creazione e la modifica di file .config.

Aggiungere impostazioni di configurazione a Web.config

La maggior parte delle applicazioni ASP.NET include un file diWeb.config predefinito che può essere modificato con qualsiasi editor di testo, ad esempio blocco note. In genere, Web.config file contengono commenti che rendono la modifica del file autoesplicativi. Potrebbe tuttavia essere necessario aggiungere elementi di configurazione a un file Web.config che non ha già definito l'elemento di configurazione. Per aggiungere un elemento di configurazione standard a un file diWeb.config , seguire questa procedura:

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

    Il fileMachine.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 è costituito da più righe, l'elemento inizia con una <element_name> riga e termina con </element_name>. L'elemento può anche essere a chiusura automatica e può essere simile a <element_name attribute1='option' attribute2='option' />. Gli spazi bianchi vengono ignorati. 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 dell'elemento <trace> di configurazione seguente è un esempio di elemento a chiusura automatica. L'esempio <trace> di 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 come l'elemento è annidato nel file Machine.config .

    Il fileMachine.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 tale 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 meno rientro.

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

    Nota

    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 l'applicazione.

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

Riferimenti