SectionInformation.ConfigSource Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Namen der Includedatei ab, in der der zugehörige Konfigurationsabschnitt definiert ist, wenn 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, setPublic Property ConfigSource As StringEigenschaftswert
Der Name der Includedatei, in der die zugeordnete ConfigurationSection Datei definiert ist, wenn eine solche Datei vorhanden ist; andernfalls eine leere Zeichenfolge ("").
Hinweise
Die ConfigSource Eigenschaft stellt den Wert des configSource Attributs dar, das 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 Include-Dateien kann zu einer logischeren und modulareren Struktur für Konfigurationsdateien führen.
Dateizugriffssicherheit und -berechtigungen können verwendet werden, um den Zugriff auf Abschnitte der Konfigurationseinstellungen einzuschränken.
Einstellungen in einer Includedatei, die während der Anwendungsinitialisierung nicht verwendet wird, 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 Konfigurationsdatei erfordert, dass die Anwendung neu gestartet werden muss, wenn sie geändert werden, legen Sie die RestartOnExternalChanges Eigenschaft auf true.
In ASP.NET Anwendungen können Sie zur Laufzeit der Eigenschaft den ConfigSource Namen einer alternativen Konfigurationsdatei zuweisen. In diesem Fall werden die Inhalte der Datei durch die standardmäßigen Verbindungszeichenfolgeninformationen ü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 datei Web.config keine Verbindungszeichenfolgeninformationen enthält, wird der alternativen Datei ein leerer Abschnitt hinzugefügt.
