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

  • Artikel

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

              Originale Produktversion: ASP.NET
Ursprüngliche KB-Nummer: 815179

Zusammenfassung

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

Hierarchie der .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 in der Regel auf einem einzigen System vorhanden sein.

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 ASP.NET Konfigurationseinstellungen für eine einzelne Anwendung ändern, wenn Sie eine Web.config-Datei im Stammordner der Anwendung erstellen. Wenn Sie dies tun, setzen die Einstellungen in der Web.config-Datei die Einstellungen in der Machine.config-Datei außer Kraft.

Erstellen einer Web.config-Datei

Sie können eine Web.config Datei erstellen, indem Sie einen Text-Editor wie Editor verwenden. Sie müssen eine Textdatei mit dem NamenWeb.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 ähnelt.

Die Web.config-Datei darf nur Einträge für Konfigurationselemente enthalten, die die Einstellungen in der Machine.config-Datei außer Kraft setzen. Die Web.config Datei muss mindestens über das <configuration> -Element und das <system.web> -Element verfügen. 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 sowie das <system.web> Element der Web.config Datei. Diese Zeilen allein führen nichts aus. Die Zeilen bieten jedoch eine Struktur, mit der Sie zukünftige Konfigurationseinstellungen hinzufügen können. Sie fügen den Großteil der ASP.NET Konfigurationseinstellungen zwischen den <system.web> Zeilen und </system.web> hinzu. Diese Zeilen markieren den Anfang und das Ende der ASP.NET Konfigurationseinstellungen.

References