SectionInformation.ConfigSource Свойство

Определение

Пространство имен:

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Исходный код:

SectionInformation.cs

Возвращает или задает имя файла включения, в котором определен связанный раздел конфигурации, если такой файл существует.

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

Значение свойства

String

Имя файла включения, в котором определен связанный ConfigurationSection файл, если такой файл существует; в противном случае — пустая строка ("").

Комментарии

Свойство ConfigSource представляет значение атрибута, указанного configSource для ConfigurationSection объекта, связанного SectionInformation с объектом.

Реализация ConfigurationSection может дополнительно указать отдельный файл, в котором определены параметры конфигурации для этого раздела. Это может быть полезно несколькими способами:

• Использование файлов include может привести к более логической и модульной структуре для файлов конфигурации.

• Безопасность и разрешения доступа к файлам можно использовать для ограничения доступа к разделам параметров конфигурации.

• Параметры в файле включения, который не используется во время инициализации приложения, можно изменить и перезагрузить без необходимости перезапуска приложения.

В следующем примере показано, как этот атрибут используется в файле конфигурации, чтобы указать, что pages раздел определен во внешнем файле включения:

<pages configSource="pages.config"/>

Если любой из параметров в файле конфигурации включает в себя требование перезапуска приложения при изменении, задайте RestartOnExternalChanges для свойства значение true.

В ASP.NET приложениях во время выполнения можно назначить ConfigSource свойству имя альтернативного файла конфигурации. В этом случае содержимое файла перезаписывается данными строки подключения по умолчанию, содержащейся в файле Web.config. Это также происходит, если альтернативный файл не существует, и он создается во время выполнения. Если файл Web.config не содержит никаких сведений о строке подключения, в альтернативный файл добавляется пустой раздел.

См. также раздел

• RestartOnExternalChanges