Freigeben über

Bearbeiten der Konfiguration einer ASP.NET Anwendung

In diesem Artikel wird beschrieben, wie Sie die Web.config-Datei einer ASP.NET Anwendung bearbeiten.

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

Zusammenfassung

Die Datei "Web.config " definiert das Verhalten von ASP.NET Anwendungen. Microsoft .NET Framework, einschließlich ASP.NET, verwendet XML-formatierte .config-Textdateien zum Konfigurieren von Anwendungen. Dies 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 zum Erstellen und Ändern von CONFIG-Dateien.

Hinzufügen von Konfigurationseinstellungen zu Web.config

Die meisten ASP.NET Anwendungen enthalten eine vordefinierte Web.config-Datei , die mit einem beliebigen Texteditor wie Editor bearbeitet werden kann. Im Allgemeinen enthalten Web.config-Dateien Kommentare, die die Bearbeitung der Datei selbsterklärend machen. Möglicherweise müssen Sie einer Web.config-Datei jedoch Konfigurationselemente hinzufügen, die noch nicht das Konfigurationselement definiert haben. Führen Sie die folgenden Schritte aus, um einer Web.config-Datei ein Standardkonfigurationselement hinzuzufügen:

  1. Öffnen Sie die Datei Machine.config in einem Text-Editor wie Editor.

    Die Datei "Machine.config " befindet sich im %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ Verzeichnis.

  2. Suchen Sie in der Datei "Machine.config " die Konfigurationseinstellung, die Sie in der Datei "Web.config " außer Kraft setzen möchten. Wenn das Element mehr als eine Zeile ist, beginnt das Element mit einer <element_name> Linie und endet mit </element_name>. Das Element kann auch selbstschließend sein und ähnlich aussehen wie <element_name attribute1='option' attribute2='option' />. Leerzeichen werden ignoriert. Daher kann das Element mehrere Zeilen umfassen. Dem Element kann ein Kommentar vorangestellt werden. Der Kommentar ist in <!-- and --> Markierungen enthalten. Das <trace> folgende Konfigurationselementbeispiel ist ein Beispiel für ein selbstschließendes Element. Das <trace> Konfigurationselementbeispiel weist mehrere Attribute auf, erstreckt sich über mehrere Zeilen und hat einen Kommentar am Anfang.

    <!--
trace Attributes:
    enabled="[true|false]" - Enable application tracing
    localOnly="[true|false]" - View trace results from localhost only
    pageOutput="[true|false]" - Display trace output on individual pages
    requestLimit="[number]" - Number of trace results available in trace.axd
    traceMode="[SortByTime|SortByCategory]" - Sorts trace result displays based on Time or Category
 -->
<trace
    enabled="false"
    localOnly="true"
    pageOutput="false"
    requestLimit="10"
    traceMode="SortByTime"
/>

  3. Kopieren Sie das gesamte Konfigurationselement und jeden Anfangskommentar in die Zwischenablage.

  4. Bestimmen Sie, wie das Element in der Datei "Machine.config " geschachtelt ist.

    Die Datei "Machine.config " ist hierarchisch, und Konfigurationselemente werden in anderen Elementen geschachtelt. Wenn Sie ein Konfigurationselement aus der Datei "Machine.config" in die Datei "Web.config" kopieren, müssen Sie dieses Konfigurationselement in dasselbe Element schachteln, aus dem es kopiert wurde. Um das Element der Machine.config-Datei zu ermitteln, in der das Konfigurationselement enthalten ist, scrollen Sie in der Datei "Machine.config " nach oben, bis Sie ein element gefunden haben, das geöffnet wird, nicht geschlossen. Das enthaltende Element ist einfach zu identifizieren, da Elemente auf höherer Ebene weniger Einzug aufweisen.

    Die meisten ASP.NET Konfigurationselemente sind im <system.web> Element enthalten. Das Ende des Elements ( </system.web> ) muss nach dem Konfigurationselement platziert werden.

    Notiz

    Das Element, in dem ihr Konfigurationselement enthalten ist. Sie müssen dieses Element in dasselbe Element in der Datei "Web.config " einfügen. Ein Konfigurationselement kann in mehreren Elementen geschachtelt werden. Sie müssen alle Elemente auf höherer Ebene in der Datei "Web.config " erstellen.

  5. Schließen Sie die Datei "Machine.config", und öffnen Sie dann die Datei "Web.config" im Stammverzeichnis Ihrer ASP.NET Anwendung.

  6. Fügen Sie das Konfigurationselement zwischen dem Anfang und dem Ende des Elements ein, das Sie in Schritt 4 identifiziert haben.

    Wenn das Konfigurationselement beispielsweise im <system.web> Element enthalten ist, muss das Konfigurationselement unmittelbar nach der öffnenden Zeile des <system.web> Elements und vor der </system.web> schließenden Zeile eingefügt werden.

  7. Ändern Sie das Konfigurationselement in der Datei "Web.config", um die Einstellung "Machine.config" für diese Anwendung außer Kraft zu setzen.

    Diese Einstellung gilt für den Ordner, der die Datei "Web.config " und alle Unterordner enthält.

References