SectionInformation.ConfigSource Właściwość

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

SectionInformation.cs

Pobiera lub ustawia nazwę pliku dołączania, w którym zdefiniowano skojarzą sekcję konfiguracji, jeśli taki plik istnieje.

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

Wartość właściwości

String

Nazwa pliku dołączania, w którym jest definiowany skojarzony ConfigurationSection plik, jeśli taki plik istnieje; w przeciwnym razie pusty ciąg ("").

Uwagi

Właściwość ConfigSource reprezentuje wartość atrybutu configSource określonego dla ConfigurationSection obiektu skojarzonego z obiektem SectionInformation .

Implementacja ConfigurationSection może opcjonalnie określić oddzielny plik, w którym zdefiniowano ustawienia konfiguracji dla tej sekcji. Może to być przydatne na wiele sposobów:

• Użycie plików dołączania może spowodować bardziej logiczną i modułową strukturę plików konfiguracji.

• Zabezpieczenia i uprawnienia dostępu do plików mogą służyć do ograniczania dostępu do sekcji ustawień konfiguracji.

• Ustawienia w pliku dołączania, który nie są używane podczas inicjowania aplikacji, można modyfikować i ponownie ładować bez konieczności ponownego uruchamiania aplikacji.

W poniższym przykładzie pokazano, jak ten atrybut jest używany w pliku konfiguracji w celu określenia, że pages sekcja jest zdefiniowana w zewnętrznym pliku dołączania:

<pages configSource="pages.config"/>

Jeśli którekolwiek z ustawień w konfiguracji dołącza plik dołączania wymaga ponownego uruchomienia aplikacji po ich zmodyfikowaniu, ustaw RestartOnExternalChanges właściwość na true.

W ASP.NET aplikacjach w czasie wykonywania można przypisać do ConfigSource właściwości nazwę alternatywnego pliku konfiguracji. W takim przypadku zawartość pliku jest zastępowana domyślnie parametry połączenia informacji zawartych w pliku Web.config. Dzieje się tak również wtedy, gdy plik alternatywny nie istnieje i jest tworzony w czasie wykonywania. Jeśli plik Web.config nie zawiera żadnych informacji parametry połączenia, do pliku alternatywnego zostanie dodana pusta sekcja.

Zobacz też

• RestartOnExternalChanges