Udostępnij za pośrednictwem


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

ConfigurationLocation

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)

ConfigurationLocation

Koncepcje

ASP.NET Configuration Overview

Securing Configuration

Locking Configuration Settings

Configuration <location> Settings

Inne zasoby

ASP.NET ustawienia konfiguracji