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 di .config in formato XML per configurare le applicazioni. Questa pratica si discostamento 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 che è possibile usare per creare e modificare i file .config.

Gerarchia dei file .config

.NET Framework si basa su file .config per definire le opzioni di configurazione. I file .config sono file XML basati su testo. In un unico sistema possono esistere più file .config, e in genere lo sono.

Le impostazioni di configurazione a livello di sistema per .NET Framework sono definite nel file Machine.config . Il fileMachine.config si trova nella %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ cartella . Le impostazioni predefinite contenute nel file Machine.config possono essere modificate in modo da 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 di Web.config

È possibile creare un file diWeb.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 fileWeb.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 fileWeb.config deve contenere solo voci per gli elementi di configurazione che sostituiscono le impostazioni nel file Machine.config . Almeno, il file Web.config deve avere l'elemento <configuration> e l'elemento <system.web> . Questi elementi conterrà singoli elementi di configurazione.

L'esempio seguente mostra un file diWeb.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 come 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. Si aggiunge 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