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

In diesem Artikel wird beschrieben, wie Sie die Web.config Datei erstellen, die zum Steuern des Verhaltens einzelner ASP.NET-Anwendungen verwendet wird.

Original Version 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 Vorgehensweise ist eine Abweichung von herkömmlichen Konfigurationsmechanismen für die Registrierung und die Metabasis. Derzeit gibt es kein MMC-Snap-in (Microsoft Management Console) oder ein anderes von Microsoft bereitgestelltes Verwaltungstool, mit dem Sie Konfigurationsdateien erstellen und ändern können.

Hierarchie von config-Dateien

In der .NET Framework werden Konfigurationsoptionen anhand von config-Dateien definiert. Die config-Dateien sind textbasierte XML-Dateien. Mehrere config-Dateien können und werden in der Regel in einem einzelnen System vorhanden sein.

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

Sie können die ASP.NET-Konfigurationseinstellungen 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 Notepad 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 Format aufweisen, das der %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config Datei ähnlich ist.

Die Web.config Datei darf nur Einträge für Konfigurationselemente enthalten, mit denen die Einstellungen in der Machine.config Datei außer Kraft gesetzt werden. Die Web.config -Datei muss mindestens das- <configuration> Element und das- <system.web> Element aufweisen. Diese Elemente werden einzelne Konfigurationselemente enthalten.

Im folgenden Beispiel wird eine minimale Web.config Datei gezeigt:

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

In der ersten Web.config Datei wird das Dokument als XML-formatiert beschrieben und der Typ der Zeichencodierung angegeben. Diese erste Verbindung muss für alle config-Dateien gleich sein.

Die folgenden Zeilen markieren den Anfang und das Ende des <configuration> Elements und das Element der <system.web> Web.config Datei. Für sich genommen führen diese Zeilen keine Aktion aus. Die Zeilen bieten jedoch eine Struktur, die es Ihnen ermöglicht, zukünftige Konfigurationseinstellungen hinzuzufügen. Sie fügen den Großteil der ASP.NET-Konfigurationseinstellungen zwischen den <system.web> und- </system.web> Zeilen hinzu. Diese Zeilen markieren den Anfang und das Ende der ASP.NET-Konfigurationseinstellungen.

Informationsquellen