SectionInformation.ConfigSource Свойство

Определение

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

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

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

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

Комментарии

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

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

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

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

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

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

<pages configSource="pages.config"/>

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

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

Применяется к

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