Obecné atributy, které jsou děděny všemi prvky oddílu

Technologie ASP.NET aplikuje nastavení konfigurace na prostředky hierarchickým způsobem. Nastavení konfigurace jsou děděny z nadřazených konfiguračních souborů. Toto téma obsahuje seznam několika obecných atributů, které jsou zděděny všemi prvky oddílu.

Prvky oddílu

Prvky oddílu jsou členy oddílů konfigurace. Tato možnost nezahrnuje prvky, které jsou členy skupin oddílu konfigurace.

Deklarace sekce konfigurace se zobrazí v horní části konfiguračního souboru uvnitř elementu configSections. Každá deklarace obsažená v elementu section určuje název oddílu a název třídy rozhraní .NET Framework (odvozené od ConfigurationSection), která zpracovává data konfigurace v této části. Značky section mohou být seskupeny do značek sectionGroup.

Další informace naleznete v tématech Konfigurační soubory technologie ASP.NET a Úpravy souborů konfigurace technologie ASP.NET.

Obecné atributy

Následující tabulka popisuje obecné atributy, které lze nastavit pro všechny prvky oddílu. Tyto obecné atributy jsou také zděděny podřízenými prvky oddílu. Všechny atributy, jejichž názvy obsahují slovo lock, jsou určeny k ochraně zadaného obsahu v konfiguračním souboru před změnou. Žádný element nebo atribut není ve výchozím nastavení uzamčený.

Atribut	Popis
configSource	Volitelný String atributu. Určuje název vkládaného souboru, ve kterém je definována přidružená konfigurace oddílu, pokud takovýto soubor existuje. Je programově přístupný prostřednictvím vlastnosti ConfigSource. Pokud použijete atribut configSource, je potřeba přesunout celý oddíl do samostatného souboru, jinak by žádná data nebyla sloučena. Jakákoli změna v externím souboru způsobí ve výchozím nastavení restartování aplikace. Chcete-li toto chování změnit tak, aby se aplikace nerestartovala při každé změně, můžete nakonfigurovat Podelement section elementu configSections (obecné schéma nastavení) v souboru web.config a nastavit jeho atribut restartOnExternalChanges na false.
lockAllAttributesExcept	Volitelný atribut String. Hodnota může být čárkami oddělený seznam. Uzamkne všechny atributy nadřazeného elementu s výjimkou zadaných. Je programově přístupný prostřednictvím vlastnosti LockAllAttributesExcept. Nižší úrovně hierarchie konfigurace nemohou nikdy uzamknout úrovně, které jsou nad nimi v hierarchii.
lockAllElementsExcept	Volitelný atribut String. Hodnota může být čárkami oddělený seznam. Uzamkne všechny podřízené elementy nadřazeného elementu s výjimkou zadaných. Je programově přístupný prostřednictvím vlastnosti LockAllElementsExcept.
lockAttributes	Volitelný atribut String. Hodnota může být čárkami oddělený seznam. Uzamkne všechny atributy nadřazeného elementu. Je programově přístupný prostřednictvím vlastnosti LockAttributes.
lockElements	Volitelný atribut String. Hodnota může být čárkami oddělený seznam. Zamkne všechny podřízené prvky nadřazeného prvku. Je programově přístupný prostřednictvím vlastnosti LockElements.
lockItem	Nepovinný atribut String. true, pokud element, na kterém se vyskytuje atribut, by měl být uzamčen. V opačném případě false. Výchozí hodnota je false. Tento atribut, kromě toho, že je používán k uzamknutí libovolného jednotlivého elementu, lze také použít k uzamčení prvků uvnitř určité kolekce. Také lze atribut použít k uzamknutí celého oddílu. Je programově přístupný prostřednictvím vlastnosti LockItem.

Příklad

Následující příklad kódu je část souboru Machine.config. Obslužné rutiny konfiguračního oddílu jsou deklarovány pro skupinu oddílu system.web a oddíl anonymousIdentification. Níže jsou deklarovány konfigurační prvky system.Web a anonymousIdentification.

Konfigurační element system.Web je člen skupiny oddílu konfigurace, která znamená, že neobsahuje žádné atributy.

Konfigurační element anonymousIdentification je člen oddílu konfigurace. Proto dědí atributy uvedené v předchozí tabulce. Všimněte si, že jeho atribut configSource má externí soubor, který je k němu přiřazen (aby obsahoval obsah elementu), a že je atribut lockItem nastaven na hodnotu true, aby se zabránilo změně jeho obsahu.

<configuration>

  <configSections>
    <!-- Other configuration sections. -->
    <sectionGroup name="system.web" ...>
      <section name="anonymousIdentification" ... />
    </sectionGroup>
  </configSections>

  <system.web>
    <anonymousIdentification  configSource="IDSourceFile.xml" 
       lockItem="true" />
  </system.web>

</configuration>

Viz také

Úkoly

Postupy: Uzamknutí nastavení konfigurace technologie ASP.NET

Koncepty

Přehled konfigurace technologie ASP.NET

Scénáře konfigurace technologie ASP.NET

Zabezpečení konfigurace technologie ASP.NET

Úpravy souborů konfigurace technologie ASP.NET

Další zdroje

Konfigurační soubory technologie ASP.NET