WebConfigurationManager.GetSection Метод

Ссылка

Определение

Пространство имен:: Microsoft.Web.Administration

Сборка:: Microsoft.Web.Administration.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

GetSection(String)	Извлекает указанный раздел конфигурации из файла конфигурации текущего приложения.
GetSection(HttpContext, String)	Извлекает указанный раздел конфигурации из файла конфигурации приложения в связи с указанным контекстом.
GetSection(String, String, String)	Извлекает указанный раздел конфигурации, используя имя веб-сайта, виртуальный путь и путь к разделу.
GetSection(HttpContext, String, Type)	Извлекает указанный раздел конфигурации, используя указанный тип раздела конфигурации из файла конфигурации приложения в связи с указанным контекстом.
GetSection(String, String, String, Type)	Извлекает указанный раздел конфигурации, используя имя веб-сайта, виртуальный путь, путь к разделу и тип времени выполнения.

GetSection(String)

Извлекает указанный раздел конфигурации из файла конфигурации текущего приложения.

public:
 static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::String ^ sectionPath);

public static Microsoft.Web.Administration.ConfigurationSection GetSection (string sectionPath);

static member GetSection : string -> Microsoft.Web.Administration.ConfigurationSection

Public Shared Function GetSection (sectionPath As String) As ConfigurationSection

Параметры

sectionPath: String

Имя раздела конфигурации.

Возвращаемое значение

ConfigurationSection

Указанный объект раздела конфигурации или null, если раздел не существует.

Исключения

ConfigurationErrorsException

Не удается загрузить допустимый файл конфигурации.

Если перегрузка GetSection(String) вызывается из веб-приложения, она возвращает раздел из файла конфигурации, выбранного системой в соответствии с иерархией конфигурации веб-приложения.

Внимание!

Если приложение использует протокол, отличный от HTTP, необходимо использовать перегрузку GetSection(HttpContext, String) или GetSection(String, String, String, Type) , каждый из которых принимает имя раздела и System.Web.HttpContext объект в списке параметров. Необходимо указать , HttpContext чтобы позволить системе возвращать параметры конфигурации на определенном уровне иерархии конфигурации. Однако, если указанный путь конфигурации находится за пределами текущего приложения, GetSection и GetSection(String, String, String, Type) возвращает параметры конфигурации на уровне приложения для текущего запущенного приложения. Если вы используете GetSection(String)параметр , который принимает только имя раздела, система всегда будет пытаться вернуть параметры конфигурации на уровне приложения.

Важно!

Использование в GetSection(String) качестве операции во время выполнения ограничено ограничениями безопасности. Например, вы не сможете получить доступ к разделу или изменить его во время выполнения.

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

GetSection(HttpContext, String)

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

public:
 static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::Web::HttpContext ^ context, System::String ^ sectionPath);

public static Microsoft.Web.Administration.ConfigurationSection GetSection (System.Web.HttpContext context, string sectionPath);

static member GetSection : System.Web.HttpContext * string -> Microsoft.Web.Administration.ConfigurationSection

Public Shared Function GetSection (context As HttpContext, sectionPath As String) As ConfigurationSection

Параметры

context: HttpContext

Контекст HttpContext текущего запроса.

sectionPath: String

Имя раздела конфигурации.

Возвращаемое значение

ConfigurationSection

Указанный объект раздела конфигурации или null, если раздел не существует.

Исключения

ConfigurationErrorsException

Не удается загрузить допустимый файл конфигурации.

Если перегрузка GetSection(HttpContext, String) вызывается из веб-приложения, она возвращает раздел из файла конфигурации, выбранного системой в соответствии с System.Web.HttpContext объектом веб-приложения.

Внимание!

Если приложение использует протокол, отличный от HTTP, необходимо использовать перегрузку GetSection(HttpContext, String) или GetSection(String, String, String, Type) , каждый из которых принимает имя раздела и имя в списке HttpContext параметров. Необходимо указать , HttpContext чтобы позволить системе возвращать параметры конфигурации на определенном уровне иерархии конфигурации. Однако, если указанный путь конфигурации находится за пределами текущего приложения, GetSection(HttpContext, String) и GetSection(String, String, String, Type) возвращает параметры конфигурации на уровне приложения для текущего запущенного приложения. При использовании перегрузки GetSection(String) , которая принимает только имя раздела, система всегда будет пытаться вернуть параметры конфигурации на уровне приложения.

Важно!

Использование в GetSection(HttpContext, String) качестве операции во время выполнения ограничено ограничениями безопасности. Например, вы не сможете получить доступ к разделу или изменить его во время выполнения.

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

GetSection(String, String, String)

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

public:
 static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::String ^ siteName, System::String ^ virtualPath, System::String ^ sectionPath);

public static Microsoft.Web.Administration.ConfigurationSection GetSection (string siteName, string virtualPath, string sectionPath);

static member GetSection : string * string * string -> Microsoft.Web.Administration.ConfigurationSection

Public Shared Function GetSection (siteName As String, virtualPath As String, sectionPath As String) As ConfigurationSection

Параметры

siteName: String

Имя веб-сайта.

virtualPath: String

Виртуальный путь к файлу Web.config.

sectionPath: String

Имя раздела конфигурации.

Возвращаемое значение

ConfigurationSection

Объект ConfigurationSection.

Исключения

ConfigurationErrorsException

Не удается загрузить допустимый файл конфигурации.

ArgumentNullException

Один из параметров, передаваемых методу , — .null

Перегрузка GetSection(String, String, String)ConfigurationSection возвращает объект , представляющий конфигурацию для запрошенного расположения. Этот метод сначала находит веб-сайт, запрошенный в параметре siteName , а затем находит файл Web.config в указанном virtualPath. GetSection(String, String, String) затем выполняет поиск запрошенной конфигурации sectionPathв файле Web.config .

Важно Использование в GetSection(String, String, String) качестве операции во время выполнения ограничено ограничениями безопасности. Например, вы не сможете получить доступ к разделу или изменить его во время выполнения.

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

GetSection(HttpContext, String, Type)

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

public:
 static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::Web::HttpContext ^ context, System::String ^ sectionPath, Type ^ sectionType);

public static Microsoft.Web.Administration.ConfigurationSection GetSection (System.Web.HttpContext context, string sectionPath, Type sectionType);

static member GetSection : System.Web.HttpContext * string * Type -> Microsoft.Web.Administration.ConfigurationSection

Public Shared Function GetSection (context As HttpContext, sectionPath As String, sectionType As Type) As ConfigurationSection

Параметры

context: HttpContext

Объект HttpContext текущего запроса.

sectionPath: String

Имя раздела конфигурации.

sectionType: Type

Тип раздела конфигурации

Возвращаемое значение

ConfigurationSection

Указанный объект раздела конфигурации или null, если раздел не существует.

Исключения

ConfigurationErrorsException

Не удается загрузить допустимый файл конфигурации.

ArgumentNullException

Один из параметров, передаваемых методу , — .null

InvalidOperationException

Значение sectionType параметра не является производным ConfigurationSection от класса или не предоставляет открытый конструктор.

Если перегрузка GetSection(HttpContext, String, Type) вызывается из веб-приложения, она возвращает раздел из файла конфигурации, выбранного системой в соответствии с System.Web.HttpContext объектом веб-приложения, а также sectionPath предоставленными параметрами и sectionType .

Внимание!

Если приложение использует протокол, отличный от HTTP, необходимо использовать перегрузку GetSection(HttpContext, String) или GetSection(String, String, String, Type) , каждый из которых принимает имя раздела и имя в списке HttpContext параметров. Необходимо указать , HttpContext чтобы позволить системе возвращать параметры конфигурации на определенном уровне иерархии конфигурации. Однако, если указанный путь конфигурации находится за пределами текущего приложения, GetSection(HttpContext, String) и GetSection(String, String, String, Type) возвращает параметры конфигурации на уровне приложения для текущего запущенного приложения. При использовании перегрузки GetSection(String) , которая принимает только имя раздела, система всегда будет пытаться вернуть параметры конфигурации на уровне приложения.

Важно!

Использование в GetSection(HttpContext, String, Type) качестве операции во время выполнения ограничено ограничениями безопасности. Например, вы не сможете получить доступ к разделу или изменить его во время выполнения.

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

GetSection(String, String, String, Type)

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

public:
 static Microsoft::Web::Administration::ConfigurationSection ^ GetSection(System::String ^ siteName, System::String ^ virtualPath, System::String ^ sectionPath, Type ^ sectionType);

public static Microsoft.Web.Administration.ConfigurationSection GetSection (string siteName, string virtualPath, string sectionPath, Type sectionType);

static member GetSection : string * string * string * Type -> Microsoft.Web.Administration.ConfigurationSection

Public Shared Function GetSection (siteName As String, virtualPath As String, sectionPath As String, sectionType As Type) As ConfigurationSection

Параметры

siteName: String

Имя веб-сайта.

virtualPath: String

Виртуальный путь к файлу Web.config.

sectionPath: String

Имя раздела конфигурации.

sectionType: Type

Тип времени выполнения раздела конфигурации.

Возвращаемое значение

ConfigurationSection

Объект ConfigurationSection.

Перегрузка GetSection(String, String, String, Type)ConfigurationSection возвращает объект , представляющий конфигурацию для запрошенного расположения. Этот метод сначала находит веб-сайт, запрошенный в параметре siteName , а затем находит файл Web.config в указанном virtualPath. GetSection(String, String, String, Type) затем выполняет поиск в файле Web.config запрошенной конфигурации sectionPath , которая соответствует типу времени выполнения, указанному в параметре sectionType .

Важно!

Использование в GetSection(String, String, String, Type) качестве операции во время выполнения ограничено ограничениями безопасности. Например, вы не сможете получить доступ к разделу или изменить его во время выполнения.

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

Обратная связь

Были ли сведения на этой странице полезными?

WebConfigurationManager.GetSection Метод

Определение

Перегрузки

GetSection(String)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

GetSection(HttpContext, String)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

GetSection(String, String, String)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

GetSection(HttpContext, String, Type)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

GetSection(String, String, String, Type)

Параметры

Возвращаемое значение

Комментарии

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