Udostępnij za pośrednictwem


SectionInformation.ConfigSource Właściwość

Definicja

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

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.

Dotyczy

Zobacz też