<section> , element
Zawiera deklarację sekcji konfiguracji.
<Konfiguracji>
<Configsections>
<Sekcji>
<Konfiguracji>
<Configsections>
<sectionGroup>
<Sekcji>
Składnia
<section name="section name"
type="configuration section handler class, assembly"
allowDefinition="Everywhere|MachineOnly|MachineToApplication"
allowLocation="true|false" />
Wymagane atrybuty
| Opis | |
|---|---|
| Nazwa | Określa nazwę sekcji konfiguracji. |
| Typu | Określa nazwę klasy procedury obsługi sekcji konfiguracji, która odczytuje sekcję z pliku konfiguracji. Wartość typu ma składnię "fully-qualified-section-handler-class-name, simple-assembly-name". Prosta nazwa zestawu to główna nazwa pliku bez rozszerzenia pliku.dll . |
Atrybuty opcjonalne
Następujące atrybuty mają zastosowanie tylko w przypadku aplikacji ASP.NET. System konfiguracji ignoruje te atrybuty dla innych typów aplikacji.
| Opis | |
|---|---|
| allowDefinition | Określa, w którym pliku konfiguracji można użyć sekcji. Użyj jednej z następujących wartości: Wszędzie Umożliwia używanie sekcji w dowolnym pliku konfiguracji. Jest to opcja domyślna. MachineOnly Umożliwia używanie sekcji tylko w pliku konfiguracji maszyny (Machine.config). Machinetoapplication Umożliwia użycie sekcji w pliku konfiguracji komputera lub pliku konfiguracji aplikacji. |
| allowLocation | Określa, czy sekcja może być używana w elemecie< location>. Użyj jednej z następujących wartości: True Umożliwia użycie sekcji w elemecie <location> . Jest to opcja domyślna. False Nie zezwala na używanie sekcji w elemecie <location> . |
Elementy nadrzędne
| Opis | |
|---|---|
| <configSections> , element | Zawiera sekcję konfiguracji i deklaracje przestrzeni nazw. |
| <sectionGroup> , element | Definiuje przestrzeń nazw dla sekcji konfiguracji. |
Uwaga
Element <sekcji> jest elementem <podrzędnym configSections> lub <sectionGroup> , ale nie obu.
Elementy podrzędne
Brak
Uwagi
Deklarowanie sekcji konfiguracji zasadniczo definiuje nowy element dla pliku konfiguracji. Nowy element zawiera ustawienia odczytu programu obsługi sekcji konfiguracji (czyli klasy implementujące interfejs).IConfigurationSectionHandler Atrybuty i elementy podrzędne zdefiniowanej sekcji zależą od procedury obsługi sekcji używanej do odczytywania ustawień.
Deklarowanie procedury obsługi sekcji konfiguracji w pliku Machine.config umożliwia użycie sekcji konfiguracji w dowolnym pliku konfiguracji aplikacji na tym komputerze, chyba że atrybut allowDefinition określa inaczej.
Przykład
W poniższym przykładzie pokazano, jak zdefiniować sekcję konfiguracji i zdefiniować ustawienia dla tej sekcji:
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler"
allowLocation="false" />
</configSections>
<sampleSection setting1="Value1"
setting2="value two"
setting3="third value" />
</configuration>
Plik konfiguracji
Tego elementu można użyć w pliku konfiguracji aplikacji, pliku konfiguracji maszyny (Machine.config) i Web.config plików, które nie znajdują się na poziomie katalogu aplikacji.
