Bearbeiten der Konfiguration einer ASP.NET-Anwendung

  • Artikel

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

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

Zusammenfassung

Die Web.config-Datei definiert das Verhalten von ASP.NET Anwendungen. Die 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 MMC-Snap-In (Microsoft Management Console) oder ein anderes von Microsoft bereitgestelltes Verwaltungstool zum Erstellen und Ändern .config Dateien.

Hinzufügen von Konfigurationseinstellungen zu Web.config

Die meisten ASP.NET Anwendungen verfügen über eine vordefinierte Web.config-Datei , die mit jedem Text-Editor 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 jedoch Konfigurationselemente zu einer Web.config-Datei hinzufügen, für die das Konfigurationselement noch nicht definiert ist. Führen Sie die folgenden Schritte aus, um einer Web.config-Datei ein Standardkonfigurationselement hinzuzufügen:

  1. Öffnen Sie die Machine.config-Datei in einem Text-Editor, z. B. Editor.

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

  2. Suchen Sie in der Machine.config-Datei die Konfigurationseinstellung, die Sie in Ihrer Web.config-Datei außer Kraft setzen möchten. Wenn das Element mehr als eine Zeile ist, beginnt das Element mit einer <element_name> Zeile und endet mit </element_name>. Das -Element kann auch selbstschließend sein und ähnlich <element_name attribute1='option' attribute2='option' />aussehen. Leerräume 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 verfügt über mehrere Attribute, umfasst 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 alle Anfangskommentare in die Zwischenablage.

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

    Die Machine.config Datei ist hierarchisch, und Konfigurationselemente sind in anderen Elementen geschachtelt. Wenn Sie ein Konfigurationselement aus der Machine.config-Datei in die Web.config-Datei kopieren, müssen Sie dieses Konfigurationselement in demselben Element schachteln, aus dem es kopiert wurde. Um das Element der Machine.config Datei zu bestimmen, in der das Konfigurationselement enthalten ist, scrollen Sie in der Machine.config Datei nach oben, bis Sie ein Element finden, das geöffnet und nicht geschlossen ist. 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.

    Hinweis

    Das Element, in dem ihr Konfigurationselement enthalten ist. Sie müssen dieses Element in dasselbe Element in der Web.config-Datei einfügen. Ein Konfigurationselement kann in mehreren Elementen geschachtelt sein. Sie müssen alle Übergeordneten Elemente in der Web.config-Datei erstellen.

  5. Schließen Sie die Machine.config-Datei , und verwenden Sie dann Ihren Text-Editor, um die Web.config-Datei im Stammverzeichnis Ihrer ASP.NET-Anwendung zu öffnen.

  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 Web.config-Datei , um die Machine.config-Einstellung für diese Anwendung außer Kraft zu setzen.

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

References