SectionInformation.ConfigSource Tulajdonság

Definíció

Névtér:

System.Configuration

Szerelvény:

System.Configuration.ConfigurationManager.dll

Csomag:

System.Configuration.ConfigurationManager v11.0.0-rc.1.26425.128

Forrás:

SectionInformation.cs

Lekéri vagy beállítja annak a belefoglalási fájlnak a nevét, amelyben a társított konfigurációs szakasz definiálva van, ha létezik ilyen fájl.

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

Tulajdonság értéke

String

Annak a belefoglaló fájlnak a neve, amelyben a társított ConfigurationSection definiálva van, ha létezik ilyen fájl; ellenkező esetben egy üres sztring ("").

Megjegyzések

A ConfigSource tulajdonság az objektumhoz configSource társított objektumhoz ConfigurationSection megadott attribútum értékét SectionInformation jelöli.

A ConfigurationSection megvalósítás opcionálisan megadhat egy külön fájlt, amelyben az adott szakasz konfigurációs beállításai meg vannak határozva. Ez több szempontból is hasznos lehet:

• A belefoglalási fájlok használata logikusabb és modulárisabb struktúrát eredményezhet a konfigurációs fájlokhoz.

• A fájlhozzáférés biztonsága és engedélyei a konfigurációs beállítások szakaszaihoz való hozzáférés korlátozására használhatók.

• Az alkalmazás inicializálása során nem használt belefoglaló fájlok beállításai az alkalmazás újraindítása nélkül módosíthatók és újra betölthetők.

Az alábbi példa bemutatja, hogyan használja ezt az attribútumot egy konfigurációs fájlban annak megadására, hogy a pages szakasz egy külső belefoglalási fájlban legyen definiálva:

<pages configSource="pages.config"/>

Ha a konfigurációban szereplő beállítások bármelyike tartalmazza a fájlokat, az alkalmazásnak újra kell indítania őket a módosításukkor, állítsa a tulajdonságot a RestartOnExternalChanges következőre true: .

ASP.NET alkalmazásokban futtatáskor hozzárendelheti a ConfigSource tulajdonsághoz egy alternatív konfigurációs fájl nevét. Ebben az esetben a fájl tartalmát felülírja az alapértelmezett kapcsolati karakterlánc információ, amely a Web.config fájlban található. Ez akkor is előfordul, ha az alternatív fájl nem létezik, és futásidőben jön létre. Ha a Web.config fájl nem tartalmaz kapcsolati karakterlánc információt, a rendszer egy üres szakaszt ad hozzá a másik fájlhoz.

Lásd még

• RestartOnExternalChanges