Erstellen der Web.config-Datei für eine ASP.NET Anwendung

In diesem Artikel wird beschrieben, wie Sie die Web.config Datei erstellen, die verwendet wird, um das Verhalten einzelner ASP.NET Anwendungen zu steuern.

Originalversion des Produkts: ASP.NET
Ursprüngliche KB-Nummer: 815179

Zusammenfassung

Die Microsoft .NET Framework und insbesondere ASP.NET verwendet XML-formatierte .config-Dateien zum Konfigurieren von Anwendungen. Diese Praxis ist eine Abkehr von herkömmlichen Registrierungs- und Metabasiskonfigurationsmechanismen. Derzeit gibt es kein Microsoft Management Console (MMC)-Snap-In oder ein anderes von Microsoft bereitgestelltes Verwaltungstool, mit dem Sie .config Dateien erstellen und ändern können.

Hierarchie von .config Dateien

Die .NET Framework basiert auf .config Dateien, um Konfigurationsoptionen zu definieren. Die .config Dateien sind textbasierte XML-Dateien. Mehrere .config Dateien können und sind in der Regel auf einem einzigen System vorhanden.

Systemweite Konfigurationseinstellungen für die .NET Framework werden in der Machine.config Datei definiert. Die Machine.config Datei befindet sich im %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ Ordner. Die Standardeinstellungen, die in der Machine.config Datei enthalten sind, können geändert werden, um das Verhalten von Microsoft .NET-Anwendungen auf dem gesamten System zu beeinflussen.

Sie können die Konfigurationseinstellungen für ASP.NET für eine einzelne Anwendung ändern, wenn Sie eine Web.config Datei im Stammordner der Anwendung erstellen. Wenn Sie dies tun, überschreiben die Einstellungen in der Web.config Datei die Einstellungen in der Machine.config Datei.

Erstellen einer Web.config Datei

Sie können eine Web.config Datei mithilfe eines Text-Editors wie Editor erstellen. Sie müssen eine Textdatei mit dem Namen Web.config im Stammverzeichnis Ihrer ASP.NET Anwendung erstellen. Die Web.config Datei muss ein wohlgeformtes XML-Dokument sein und ein ähnliches Format wie die %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config Datei aufweisen.

Die Web.config-Datei darf nur Einträge für Konfigurationselemente enthalten, die die Einstellungen in der Machine.config-Datei außer Kraft setzen. Mindestens muss die Web.config Datei über das <configuration> Element und das Element verfügen <system.web> . Diese Elemente enthalten einzelne Konfigurationselemente.

Das folgende Beispiel zeigt eine minimale Web.config Datei:

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

Die erste Zeile der Web.config-Datei beschreibt das Dokument als XML-formatiert und gibt den Zeichencodierungstyp an. Diese erste Zeile muss für alle .config Dateien identisch sein.

Die folgenden Zeilen markieren den Anfang und das Ende des <configuration> Elements und das <system.web> Element der Web.config Datei. Diese Zeilen allein tun nichts. Die Zeilen bieten jedoch eine Struktur, mit der Sie zukünftige Konfigurationseinstellungen hinzufügen können. Sie fügen die meisten ASP.NET Konfigurationseinstellungen zwischen den <system.web> Zeilen hinzu </system.web> . Diese Zeilen markieren den Anfang und das Ende der Konfigurationseinstellungen für ASP.NET.

References