SectionInformation.ConfigSource Eigenschaft

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

SectionInformation.cs

Ruft den Namen der Includedatei ab, in der der zugeordnete Konfigurationsabschnitt definiert ist, sofern eine solche Datei vorhanden ist, oder legt diesen fest.

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

Eigenschaftswert

String

Der Name der Includedatei, in der der zugeordnete ConfigurationSection definiert ist, sofern eine solche Datei vorhanden ist, andernfalls eine leere Zeichenfolge ("").

Hinweise

Die ConfigSource -Eigenschaft stellt den Wert des Attributs dar, das configSource für ein ConfigurationSection Objekt angegeben wird, das dem SectionInformation Objekt zugeordnet ist.

Eine ConfigurationSection Implementierung kann optional eine separate Datei angeben, in der die Konfigurationseinstellungen für diesen Abschnitt definiert sind. Dies kann auf mehrere Arten nützlich sein:

• Die Verwendung von Includedateien kann zu einer logischeren und modulareren Struktur für Konfigurationsdateien führen.

• Die Sicherheit und Berechtigungen für den Dateizugriff können verwendet werden, um den Zugriff auf Abschnitte der Konfigurationseinstellungen einzuschränken.

• Einstellungen in einer Includedatei, die während der Anwendungsinitialisierung nicht verwendet werden, können geändert und neu geladen werden, ohne dass ein Anwendungsneustart erforderlich ist.

Das folgende Beispiel zeigt, wie dieses Attribut in einer Konfigurationsdatei verwendet wird, um anzugeben, dass der pages Abschnitt in einer externen Includedatei definiert ist:

<pages configSource="pages.config"/>

Wenn eine der Einstellungen in einer Konfigurationseinschließdatei erfordert, dass die Anwendung beim Ändern neu gestartet wird, legen Sie die RestartOnExternalChanges -Eigenschaft auf fest true.

In ASP.NET Anwendungen können Sie der Eigenschaft zur ConfigSource Laufzeit den Namen einer alternativen Konfigurationsdatei zuweisen. In diesem Fall wird der Inhalt der Datei standardmäßig Verbindungszeichenfolge Informationen überschrieben, die in der Web.config-Datei enthalten sind. Dies tritt auch auf, wenn die alternative Datei nicht vorhanden ist und zur Laufzeit erstellt wird. Wenn die Web.config-Datei keine Verbindungszeichenfolge Informationen enthält, wird der Alternativdatei ein leerer Abschnitt hinzugefügt.

Weitere Informationen

• RestartOnExternalChanges