Bearbeiten der Konfiguration einer ASP.NET Anwendung

  • Artikel
  • 2 Minuten Lesedauer

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 Web.config datei definiert das Verhalten ASP.NET Anwendungen. Die Microsoft .NET Framework, einschließlich ASP.NET, verwendet XML-formatierte .config Textdateien, um Anwendungen zu konfigurieren. Dies unterscheidet sich 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 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 jedoch einer Web.config Datei, in der das Konfigurationselement noch nicht definiert ist, Konfigurationselemente hinzufügen. 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 dateiMachine.config die Konfigurationseinstellung, die Sie überschreiben möchten, in Der Web.config Datei. Wenn das Element mehrere Zeilen enthält, beginnt das Element mit einer <element_name> Zeile und endet mit </element_name>. Das Element kann auch selbstschließend sein und ähnlich aussehen <element_name attribute1='option' attribute2='option' />wie . 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> Konfigurationselement weist mehrere Attribute auf, umfasst mehrere Zeilen und hat am Anfang einen Kommentar.

    <!--
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 dateiWeb.config kopieren, müssen Sie dieses Konfigurationselement in dem Element verschachteln, aus dem es kopiert wurde. Um das Element der Machine.config Datei zu ermitteln, 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 haben.

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

    Hinweis

    Das Element, in dem das Konfigurationselement enthalten ist. Sie müssen dieses Element in dasselbe Element in die dateiWeb.config einfügen. Ein Konfigurationselement kann in mehreren Elementen geschachtelt sein. Sie müssen alle Elemente auf höherer Ebene in der dateiWeb.config erstellen.

  5. Schließen Sie die Machine.config Datei, und öffnen Sie dann mit dem Text-Editor die Web.config Datei 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 dateiWeb.config , um die einstellungMachine.config 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