location-Element (ASP.NET-Einstellungsschema)
Gibt die Ressource an, für die untergeordnete Konfigurationseinstellungen gültig sind, und sperrt die Konfigurationseinstellungen, sodass sie nicht mehr durch untergeordnete Konfigurationsdateien überschrieben werden können.
Dieses Element ist neu in .NET Framework, Version 2.0.
<location
allowOverride="True|False"
path="path"
/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente für dieses Element beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
allowOverride |
Optionales Boolean-Attribut. Gibt an, ob die Konfigurationseinstellungen durch Dateien Web.config in untergeordneten Verzeichnissen geändert werden können. Die Standardeinstellung ist True.. |
path |
Optionales String-Attribut. Gibt die Ressource an, für die die enthaltenen Konfigurationseinstellungen gelten. Die Verwendung von location ohne ein path-Attribut bewirkt, dass die Konfigurationseinstellungen für das aktuelle Verzeichnis und alle untergeordneten Verzeichnisse gelten. Wenn location ohne das path-Attribut verwendet wird und allowOverride auf False festgelegt wurde, können die Konfigurationseinstellungen nicht durch Dateien Web.config in untergeordneten Verzeichnissen geändert werden. |
inheritInChildApplications |
Optionales Boolean-Attribut. Gibt an, ob die Konfigurationseinstellungen, die für eine bestimmte Position spezifisch sind (z. B. das Stammverzeichnis einer Website), von Anwendungen geerbt werden, die sich in Unterverzeichnissen befinden. Die Standardeinstellung ist True.. |
Untergeordnete Elemente
Das location-Element kann andere Elemente umschließen, um entweder die Konfigurationseinstellungen auf eine bestimmte Ressource anzuwenden, oder um die Konfigurationseinstellungen zu sperren.
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird. |
Hinweise
Das location-Element gibt die Ressource an, für die untergeordnete Konfigurationseinstellungen gültig sind. Des Weiteren dient es zum Sperren der Konfigurationseinstellungen, sodass sie nicht mehr durch untergeordnete Konfigurationsdateien überschrieben werden können.
Das location-Element kann andere Elemente umschließen, um entweder die Konfigurationseinstellungen auf eine bestimmte Ressource anzuwenden, oder um die Einstellungen zu sperren. Weitere Informationen finden Sie unter Konfigurieren von bestimmten Dateien und Unterverzeichnissen und Sperren von Konfigurationseinstellungen.
Beispiel
Das folgende Codebeispiel veranschaulicht, wie einem anonymen Benutzer der Zugriff auf die Seite Logon.aspx ermöglicht wird.
<configuration>
<location path="Logon.aspx">
<system.web>
<authorization>
<allow users="?"/>
</authorization>
</system.web>
</location>
</configuration>
Das folgende Codebeispiel veranschaulicht, wie die Größenbeschränkung der angegebenen Seite für hochgeladene Dateien auf 128 KB festgelegt wird.
<configuration>
<location path="UploadPage.aspx">
<system.web>
<httpRuntime maxRequestLength="128"/>
</system.web>
</location>
</configuration>
Das folgende Codebeispiel veranschaulicht, wie das Ändern der Konfigurationseinstellungen durch Dateien Web.config in untergeordneten Verzeichnissen verhindert wird.
<configuration>
<location allowOverride="false"/>
</configuration>
Elementinformationen
Konfigurationsabschnittshandler |
Nicht vorhanden. |
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physikalischer Verzeichnisse |
Anforderungen |
Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005 |
Siehe auch
Aufgaben
Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen
Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen
Referenz
configuration-Element (allgemeines Einstellungsschema)
Konzepte
Übersicht über die ASP.NET-Konfiguration
Absichern der ASP.NET-Konfiguration
Sperren von Konfigurationseinstellungen
Konfigurieren von bestimmten Dateien und Unterverzeichnissen