SectionInformation.ConfigSource Vlastnost

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Zdroj:

SectionInformation.cs

Získá nebo nastaví název zahrnutého souboru, ve kterém je definován přidružený konfigurační oddíl, pokud takový soubor existuje.

public:
 property System::String ^ ConfigSource { System::String ^ get(); void set(System::String ^ value); };

public string ConfigSource { get; set; }

member this.ConfigSource : string with get, set

Public Property ConfigSource As String

Hodnota vlastnosti

String

Název souboru include, ve kterém je přidružený ConfigurationSection definován, pokud takový soubor existuje; jinak prázdný řetězec ("").

Poznámky

Vlastnost ConfigSource představuje hodnotu atributu configSource , který je určen pro ConfigurationSection objekt, který je přidružen k objektu SectionInformation .

Implementace ConfigurationSection může volitelně zadat samostatný soubor, ve kterém jsou definována konfigurační nastavení pro daný oddíl. To může být užitečné několika způsoby:

• Použití souborů include může vést k logičtější a modulární struktuře konfiguračních souborů.

• Zabezpečení a oprávnění přístupu k souborům je možné použít k omezení přístupu k oddílům nastavení konfigurace.

• Nastavení v souboru include, který se nepoužívá během inicializace aplikace, lze upravit a znovu načíst bez nutnosti restartování aplikace.

Následující příklad ukazuje, jak se tento atribut používá v konfiguračním souboru k určení, že pages oddíl je definován v externím souboru include:

<pages configSource="pages.config"/>

Pokud některá z nastavení v konfiguračním souboru include vyžaduje, aby se aplikace restartoval při jejich úpravě, nastavte RestartOnExternalChanges vlastnost na true.

V ASP.NET aplikacích můžete za běhu přiřadit k ConfigSource vlastnosti název alternativního konfiguračního souboru. V takovém případě se obsah souboru přepíše výchozími informacemi připojovacího řetězce, které jsou obsaženy v souboru Web.config. K tomu dochází také v případě, že alternativní soubor neexistuje a vytvoří se za běhu. Pokud soubor Web.config neobsahuje žádné informace o připojovacím řetězci, přidá se do alternativního souboru prázdný oddíl.

Viz také

• RestartOnExternalChanges