Lokalizacja elementu (ASP.Schemat ustawień netto)
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Określa zasób dotyczą ustawieniakonfiguracja element podrzędnyi blokuje ustawienia konfiguracja , zapobieganie zastępowaniu przez element podrzędnyplikikonfiguracja ustawień.
Ten element jest nowego w.NET Framework w wersji 2.0.
<location
allowOverride="true|false"
path="path"
/>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty i elementy element podrzędny elementy nadrzędne dla tego elementu.
Atrybuty
Atrybut |
Opis |
---|---|
allowOverride |
Opcjonalny Boolean atrybut. Określa, czy ustawienia konfiguracja mogą być zastępowane przez ustawienia konfiguracja , które są w plikach .config sieć Web, które znajdują się w katalogach element podrzędny . Wartością domyślną jesttrue. |
path |
Opcjonalny String atrybut. Określa ustawienia zawarte w konfiguracja odnoszą się do zasób . Za pomocą location z brakującego path atrybut stosuje ustawienia konfiguracja do bieżącego katalogu i wszystkich katalogach element podrzędny . Jeśli location jest używana bez path atrybut i allowOverride jest false, ustawienia konfiguracja nie może być zmieniony przez plików .config sieć Web, które znajdują się w katalogach element podrzędny . |
inheritInChildApplications |
Opcjonalny Boolean atrybut. Określa, czy ustawienia konfiguracja , które są specyficzne dla niektórych lokalizacji (na przykład w katalogu korzeń witryny sieć Web ) są dziedziczone przez aplikacje, które istnieją w podkatalogach. Wartością domyślną jesttrue. |
Elementy podrzędne
location Elementu można albo ująć inne elementy, aby zastosować ustawienia konfiguracja do określonego zasób lub blokada ustawienia konfiguracja .
Elementy nadrzędne
Element |
Opis |
---|---|
configuration |
Określa element wymagane korzeń w każdym pliku konfiguracja , który jest używany przez aparat plików wykonywalnych języka wspólnego oraz.NET Framework firmy Microsoft. |
Uwagi
location Element Określa zasób dotyczą ustawieniakonfiguracja element podrzędnyi jest także używany do ustawieniakonfiguracja blokada, zapobieganie zastępowaniu przez element podrzędnyplikikonfiguracja ustawień.
location Elementu można albo ująć inne elementy, aby zastosować ustawienia konfiguracja do określonego zasób lub blokada ustawienia. Aby uzyskać więcej informacji, zobacz Configuration <location> Settings i Locking Configuration Settings.
Przykład
Poniższy przykład kodu demonstruje, jak i umożliwienia anonimowego użytkownik umożliwiających dostęp do strony Logon.aspx.
<configuration>
<location path="Logon.aspx">
<system.web>
<authorization>
<allow users="?"/>
</authorization>
</system.web>
</location>
</configuration>
Poniższy przykład kodu demonstruje, jak ustawić limit przekazany rozmiar pliku 128 KB dla tylko określonej strony.
<configuration>
<location path="UploadPage.aspx">
<system.web>
<httpRuntime maxRequestLength="128"/>
</system.web>
</location>
</configuration>
Poniższy przykład kodu pokazuje jak zapobiec ustawienia konfiguracja przed zmianami wprowadzanymi przez plików .config sieć Web, które znajdują się w katalogach element podrzędny .
<configuration>
<location allowOverride="false"/>
</configuration>
Informacje o elementach
Program obsługi sekcji konfiguracji |
Nie stosuje się. |
Członkowskie konfiguracji |
|
Lokalizacje konfigurowalne |
Machine.config Poziom główny sieć Web.config Poziom aplikacji sieć Web.config .Config wirtualnego lub fizycznego directory–level w sieć Web |
Wymagania |
Microsoft Internet Information Services Internet (IIS) w wersji 5.0, 5.1 lub 6.0 .NET Framework w wersji 2.0 Microsoft Visual Studio 2003 lub Visual Studio 2005 |
Zobacz też
Zadania
How to: Lock ASP.NET Configuration Settings
How to: Configure Specific Folders Using Location Settings
Informacje
Konfiguracja elementu (schemat ustawień ogólne)
Koncepcje
ASP.NET Configuration Overview
Locking Configuration Settings
Configuration <location> Settings