location-Element (ASP.NET-Einstellungsschema)

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

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. Der Standardwert 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. Der Standardwert 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 Configuration <location> Settings und Locking Configuration Settings.

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	ConfigurationLocation
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physischer 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

How to: Lock ASP.NET Configuration Settings

How to: Configure Specific Folders Using Location Settings

Referenz

configuration-Element (allgemeines Einstellungsschema)

ConfigurationLocation

Konzepte

ASP.NET Configuration Overview

Securing Configuration

Locking Configuration Settings

Configuration <location> Settings

Weitere Ressourcen

ASP.NET-Konfigurationseinstellungen