SectionInformation.ConfigSource Właściwość

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Ź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 zdefiniowana skojarzona ConfigurationSection , jeśli taki plik istnieje; w przeciwnym razie pusty ciąg ("").

Uwagi

Właściwość ConfigSource reprezentuje wartość atrybutu configSource określonego ConfigurationSection dla 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łączanym, który nie są używane podczas inicjowania aplikacji, można modyfikować i ładować ponownie bez konieczności ponownego uruchamiania aplikacji.

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

<pages configSource="pages.config"/>

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

W ASP.NET aplikacji w czasie wykonywania można przypisać do ConfigSource właściwości nazwę alternatywnego pliku konfiguracji. W takim przypadku zawartość pliku jest zastępowana przez domyślne informacje o parametrach połączenia zawarte 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 o parametrach połączenia, do pliku alternatywnego zostanie dodana pusta sekcja.

Zobacz też

• RestartOnExternalChanges