SectionInformation.ConfigSource Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic Property ConfigSource As StringWartość właściwości
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.
