Condividi tramite

Creare il file Web.config per un'applicazione ASP.NET

  • Articolo

Questo articolo descrive come creare il file Web.config usato per controllare il comportamento delle singole applicazioni ASP.NET.

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

Riepilogo

Microsoft .NET Framework e ASP.NET in particolare usa file con estensione config in formato XML per configurare le applicazioni. Questa procedura è 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 che è possibile usare per creare e modificare i file con estensione config.

Gerarchia dei file con estensione config

.NET Framework si basa sui file con estensione config per definire le opzioni di configurazione. I file con estensione config sono file XML basati su testo. Più file con estensione config possono e in genere esistono in un unico sistema.

Le impostazioni di configurazione a livello di sistema per .NET Framework vengono definite nel file Machine.config . Il file Machine.config si trova nella %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ cartella . Le impostazioni predefinite contenute nel file Machine.config possono essere modificate per influire sul comportamento delle applicazioni Microsoft .NET nell'intero sistema.

È possibile modificare le impostazioni di configurazione ASP.NET per una singola applicazione se si crea un file Web.config nella cartella radice dell'applicazione. Quando si esegue questa operazione, le impostazioni nel file Web.config sostituiscono le impostazioni nel file Machine.config .

Creare un file Web.config

È possibile creare un file Web.config usando un editor di testo, ad esempio Blocco note. È necessario creare un file di testo denominato Web.config nella directory radice dell'applicazione ASP.NET. Il file Web.config deve essere un documento XML ben formato e deve avere un formato simile al %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config file.

Il file Web.config deve contenere solo voci per gli elementi di configurazione che eseguono l'override delle impostazioni nel file Machine.config . Come minimo, il file Web.config deve avere l'elemento <configuration> e l'elemento <system.web> . Questi elementi conterranno singoli elementi di configurazione.

L'esempio seguente mostra un file Web.config minimo:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.web>
    </system.web>
</configuration>

La prima riga del file Web.config descrive il documento in formato XML e specifica il tipo di codifica dei caratteri. Questa prima riga deve essere la stessa per tutti i file config.

Le righe che seguono contrassegnano l'inizio e la fine dell'elemento <configuration> e l'elemento <system.web> del file Web.config . Da soli, queste linee non fanno nulla. Tuttavia, le righe forniscono una struttura che consente di aggiungere impostazioni di configurazione future. È possibile aggiungere la maggior parte delle impostazioni di configurazione ASP.NET tra le <system.web> righe e </system.web> . Queste righe contrassegnano l'inizio e la fine delle impostazioni di configurazione ASP.NET.

Riferimenti