Element location (schéma nastavení ASP.NET)

Určuje prostředek, na jehož podřízené nastavení konfigurace se aplikuje a uzamkne nastavení konfigurace, což zabrání přepsání podřízenými konfiguračními soubory.

Tento element je v rozhraní .NET Framework verze 2.0 nový.

<location 
   allowOverride="True|False"
   path="path" 
/>

Atributy a prvky

Následující části popisují atributy, podřízený prvky a rodičovské elementy pro tento element.

v případě vícehodnotových atributů

Atribut	Popis
allowOverride	Volitelný Boolean atributu. Určuje, zda může být nastavení konfigurace přepsáno nastavením konfigurace, které je v souborech Web.config, které jsou v podřízených adresářích. Výchozí hodnota je True.
path	Nepovinný atribut String. Určuje prostředek, kterého se nastavení konfigurace týká. Použití location s chybějícím atributem path aplikuje nastavení konfigurace na aktuální adresář a všechny podřízené adresáře. V případě použití location bez atributu path a pokud allowOverride je False, nelze změnit nastavení konfigurace pomocí souborů web.config v podřízených adresářích.
inheritInChildApplications	Volitelný Boolean atributu. Určuje, zda nastavení konfigurace, které jsou specifické pro umístění (například v kořenovém adresáři webového serveru) jsou zděděny aplikací, které existují v podadresářích. Výchozí hodnota jeTrue.

Podřízené prvky

Element location může zahrnout jiné elementy buď pro aplikaci nastavení konfigurace pro konkrétní prostředek nebo pro uzamčení nastavení konfigurace.

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.

Poznámky

Element location určuje prostředek, kterého se týká konfigurační nastavení podřízeného prvku a slouží také k uzamknutí nastavení konfigurace k zabránění přepsání konfiguračními soubory podřízeného prvku.

Element location může zahrnout jiné elementy buď pro aplikaci nastavení konfigurace pro konkrétní prostředek nebo pro uzamčení nastavení. Další informace naleznete v tématu Konfigurace specifických souborů a podsložek a Uzamykání konfiguračního nastavení.

Příklad

Následující příklad kódu ukazuje, jak umožnit anonymnímu uživateli získat přístup ke stránce Logon.aspx.

<configuration>
   <location path="Logon.aspx">
      <system.web>
         <authorization>
            <allow users="?"/>
         </authorization>
      </system.web>
   </location>
</configuration>

Následující příklad kódu ukazuje, jak nastavit limit velikosti nahrávaného souboru na 128 KB pro určenou stránku.

<configuration>
  <location path="UploadPage.aspx">
    <system.web>
      <httpRuntime maxRequestLength="128"/>
    </system.web>
  </location>
</configuration>

Následující příklad kódu demonstruje, jak zabránit změnám nastavení konfigurace pomocí souborů web.config v podřízených adresářích.

<configuration>
   <location allowOverride="false"/>
</configuration>

Informace prvku

Obslužná rutina konfiguračního oddílu	Nelze aplikovat.
Konfigurační člen	ConfigurationLocation
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor web.config na úrovni fyzického nebo virtuálního adresáře
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework verze 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Úkoly

Postupy: Uzamknutí nastavení konfigurace technologie ASP.NET

Postup: Konfigurace specifických adresářů pomocí nastavení místa

Odkaz

Element configuration (schéma obecného nastavení)

ConfigurationLocation

Koncepty

Přehled konfigurace technologie ASP.NET

Zabezpečení konfigurace technologie ASP.NET

Uzamykání konfiguračního nastavení

Konfigurace specifických souborů a podsložek

Další zdroje

Nastavení konfigurace ASP.NET