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.

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

Zusammenfassung

Die Microsoft .NET Framework und insbesondere ASP.NET verwenden XML-formatierte .config dateien, um Anwendungen zu konfigurieren. Diese Vorgehensweise unterscheidet sich 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 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 im 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.configDatei.

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 aufweisen wie die %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config Datei.

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

Informationsquellen