Freigeben über

Erstellen von anwendungs- und verzeichnisspezifischen Konfigurationseinstellungen in einer ASP.NET Anwendung

In diesem Artikel wird beschrieben, wie Anwendungsspezifische und verzeichnisspezifische Konfigurationseinstellungen in ASP.NET vorgenommen werden.

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

Zusammenfassung

Die Datei "Web.config " befindet sich im Stammverzeichnis einer ASP.NET Anwendung. Die Datei "Web.config " gibt Konfigurationsinformationen an, die für die Anwendung spezifisch sind. Sie können konfigurationseinstellungen auch pro Verzeichnis festlegen. Hierfür gibt es zwei Möglichkeiten:

  • Verteilen Sie mehrere Web.config-Dateien an Verzeichnisse in der Anwendung. Fügen Sie eine Web.config-Datei im ASP.NET Anwendungsverzeichnis mit Einstellungen hinzu, die Einstellungen in einer Datei mit höherer Ebene "Web.config " oder in der Computerkonfigurationsdatei (Machine.config) überschreiben.

  • Fügen Sie die Einstellungen pro Verzeichnis oder Datei direkt zur Dateidatei "Web.config" der Anwendung hinzu. Diese Methode verwendet eine einzelne Web.config-Datei zum Aktivieren der Konfigurationseinstellungen pro Verzeichnis. Sie können diese Methode auch in der Datei "Machine.config" verwenden, um Konfigurationseinstellungen für ASP.NET Webanwendungen zu erzwingen und dann web.config-Dateien am Überschreiben von Machine.config-Einstellungen zu beenden.

Verwenden des Speicherortelements in der Datei "Machine.config"

Um Einstellungen anzugeben, die für eine Webanwendung oder ein Verzeichnis gelten, können Sie das <location> Element dem <configuration> Element einer System Machine.config-Datei hinzufügen. Es ist nützlich, wenn Sie Konfigurationseinstellungen in einer einzelnen Datei zentralisieren. Es ist auch nützlich in Webhostingumgebungen, bestimmte Konfigurationseinstellungen für einzelne Webanwendungen zu mandatieren.

Das <location> Element enthält zwei Attribute und path allowOverride. Das path Attribut definiert das Standort- oder virtuelle Verzeichnis, das von den Konfigurationseinstellungen abgedeckt wird. Um anzugeben, dass die Einstellungen im <location> Element auf die Standardwebsite angewendet werden, legen Sie das path Attribut auf Default Web Site. Um anzugeben, dass die Einstellungen für die Anwendung gelten, die "MyApp" in der Standardwebsite heißt, legen Sie das path Attribut auf Default Web Site/MyApp.

Wenn das allowOverride Attribut "false" ist, können die Web.config-Dateien in den Webanwendungsverzeichnissen die einstellungen, die Sie im <location> Element angegeben haben, nicht überschreiben. Es ist eine nützliche Einstellung in Umgebungen, in denen Sie Anwendungsentwickler bei der Konfiguration einer Webanwendung einschränken müssen. Das folgende Beispiel zeigt einen Teil einer Machine.config-Datei . Die Datei erfordert eine Authentifizierung für den Zugriff auf die MyApp-Anwendung auf der Standardwebsite und kann nicht durch Einstellungen in einer Web.config-Datei außer Kraft gesetzt werden.

<configuration>
    <location path="Default Web Site/MyApp" allowOverride="false">
        <system.web>
            <authorization>
                <allow users="?" />
            </authorization>
        </system.web>
    </location>
</configuration>

Verwenden des Speicherortelements in der Datei "Web.config"

Um Einstellungen anzugeben, die für eine bestimmte Anwendung oder ein bestimmtes Verzeichnis gelten, fügen Sie das <location> Element dem <configuration> Element einer Anwendungsweb.config-Datei hinzu. Das <location> Element enthält in der Regel ein <system.web> Element und andere Konfigurationselemente genau so, wie Sie es in der Datei "Web.config " verwenden. Das path Attribut des <location> Elements gibt das virtuelle Verzeichnis oder den Dateinamen an, auf den die Speicherortkonfigurationselemente angewendet werden. Das folgende Beispiel zeigt einen Teil einer Anwendungsweb.config-Datei, die benutzerdefinierte Fehlermeldungen für das virtuelle Forumverzeichnis angibt.

<configuration>
    <location path="forum" >
        <system.web>
            <customErrors mode="RemoteOnly" defaultRedirect="forum-error.aspx">
                <error statusCode="404" redirect="forum-file-not-found.aspx" />
            </customErrors>
        </system.web>
    </location>
</configuration>

References