location-Element (ASP.NET-Einstellungsschema)

Aktualisiert: November 2007

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.

configuration-Element (allgemeines Einstellungsschema)
  location-Element (ASP.NET-Einstellungsschema)

<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.

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	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

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen

Konzepte

Übersicht über die ASP.NET-Konfiguration

Absichern der ASP.NET-Konfiguration

Sperren von Konfigurationseinstellungen

Konfigurieren von bestimmten Dateien und Unterverzeichnissen

Referenz

configuration-Element (allgemeines Einstellungsschema)

ConfigurationLocation

Weitere Ressourcen

ASP.NET-Konfigurationseinstellungen