SectionInformation.ConfigSource Vlastnost

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

Zdroj:

SectionInformation.cs

Získá nebo nastaví název souboru zahrnutí, ve kterém je definována přidružená konfigurační část, 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 zahrnutí, ve kterém je přidružený ConfigurationSection soubor definován, pokud takový soubor existuje; v opačném případě prázdný řetězec ("").

Poznámky

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

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

• Použití souborů zahrnutí 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 zahrnutí, která se nepoužívají při inicializaci aplikace, je možné změnit 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 zahrnutí:

<pages configSource="pages.config"/>

Pokud některé z nastavení v souboru s konfiguračním zahrnutím vyžaduje, aby se aplikace při úpravě restartovat, nastavte RestartOnExternalChanges vlastnost na true.

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

Viz také

• RestartOnExternalChanges