Atrybuty ogólne dziedziczone przez elementy sekcji
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
ASP.NET stosuje ustawienia konfiguracji do zasobów w sposób hierarchiczny. Ustawienia konfiguracji są dziedziczone z nadrzędnego plików konfiguracyjnych. W tym temacie opisano kilka ogólnych atrybuty, które są dziedziczone przez wszystkie elementy z sekcji.
Elementy sekcji
Elementy sekcji są członkami sekcji konfiguracji. Obejmuje to elementy, które są członkami grupy sekcji konfiguracji.
Deklaracje sekcji konfiguracji są wyświetlane u góry pliku konfiguracyjnego wewnątrz configSections element. Każda deklaracja zawartych w sekcji element Określa nazwę sekcji i nazwy.NET Framework klasy (pochodzące z ConfigurationSection), przetwarza dane zawarte w tej sekcji. sekcja znaczniki mogą być grupowane w sectionGroup znaczniki.
Aby uzyskać więcej informacji, zobacz ASP.NET Configuration Files lub Format of ASP.NET Configuration Files.
Atrybuty ogólne
W poniższej tabeli opisano ogólne atrybutów, które mogą być ustawiane dla żadnych elementów z sekcji. Atrybuty ogólne te również są dziedziczone przez elementy podrzędne elementów sekcji. Wszystkie atrybuty, których nazwy zawierają prace lock są przeznaczone do ochrony określonej zawartości w pliku konfiguracyjnym przed zmianami. Nie element lub atrybut jest zablokowane domyślnie.
Atrybut |
Opis |
---|---|
configSource |
Opcjonalny String atrybut. Określa nazwę pliku dołączanego, w którym jest zdefiniowana w sekcji konfiguracji skojarzone, jeśli taki plik istnieje. Programowo dostępne za pośrednictwem ConfigSource właściwości. Kiedy używać configSource atrybutu, należy przenieść całą sekcję do oddzielnego pliku, ponieważ nie ma żadnych scalanie ustawienia elementu. Wszelkie zmiany do zewnętrznego pliku powoduje ponowne uruchomienie, domyślnie. Aby zmienić to zachowanie aplikacji nie jest uruchamiana ponownie po każdej zmianie, można skonfigurować sekcja elementu dla configSections (schemat ustawień ogólne) w pliku Web.config pliku i ustaw jego restartOnExternalChanges atrybutu do false. |
lockAllAttributesExcept |
Opcjonalny String atrybutu; wartość może być listę rozdzielaną przecinkami. Blokuje wszystkie atrybuty elementu nadrzędnego, z wyjątkiem tych określonych. Programowo dostępne za pośrednictwem LockAllAttributesExcept właściwości. Niższe poziomy hierarchii konfiguracji, nigdy nie można zablokować poziomów, które są nad nimi w hierarchii. |
lockAllElementsExcept |
Opcjonalny String atrybutu; wartość może być listę rozdzielaną przecinkami. Blokuje wszystkie elementy podrzędne elementu nadrzędnego, z wyjątkiem tych określonych. Programowo dostępne za pośrednictwem LockAllElementsExcept właściwości. |
lockAttributes |
Opcjonalny String atrybutu; wartość może być listę rozdzielaną przecinkami. Blokuje wszystkie atrybuty elementu nadrzędnego. Programowo dostępne za pośrednictwem LockAttributes właściwości. |
lockElements |
Opcjonalny String atrybutu; wartość może być listę rozdzielaną przecinkami. Blokuje wszystkie elementy podrzędne elementu nadrzędnego. Programowo dostępne za pośrednictwem LockElements właściwości. |
lockItem |
Opcjonalny String atrybut. trueJeśli element, w którym występuje atrybutu powinny zostać zablokowane; w przeciwnym razie false. Wartością domyślną jest false. Ten atrybut, oprócz są używane do blokowania dowolnego elementu indywidualnych, mogą być również używane na elementy kolekcji je zablokować, przede wszystkim w określonej kolekcji. Ponadto atrybut można zablokować wszelkie całej sekcji. Programowo dostępne za pośrednictwem LockItem właściwości. |
Przykład
Poniższy przykład kodu jest częścią pliku Machine.config. Programy obsługi sekcji konfiguracji są zgłoszone do system.web grupy sekcji i anonymousIdentification sekcji. Poniżej systemu.W sieci Web i anonymousIdentification zgłaszane są elementy konfiguracji.
Systemu.W sieci Web element konfiguracji jest członkiem grupy sekcji konfiguracji, co oznacza nie zawiera żadnych atrybutów.
AnonymousIdentification element konfiguracji jest członkiem sekcji konfiguracji; w związku z tym dziedziczy atrybuty wymienione w powyższej tabeli. Należy zauważyć, że jego configSource atrybut ma zewnętrzny plik powierzonych mu (do zawierają treść elementu) oraz że lockItem atrybut jest ustawiony na true Aby uniemożliwić zmiany w jego zawartości.
<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>
Zobacz też
Zadania
How to: Lock ASP.NET Configuration Settings
Koncepcje
ASP.NET Configuration Overview
Format of ASP.NET Configuration Files