WebConfigurationManager.GetSection Método

Definição

Namespace:

Microsoft.Web.Administration

Assembly:

Microsoft.Web.Administration.dll

Recupera a seção de configuração especificada do arquivo de configuração padrão do aplicativo atual.

Sobrecargas

GetSection(String)	Recupera a seção de configuração especificada do arquivo de configuração do aplicativo atual.
GetSection(HttpContext, String)	Recupera a seção de configuração especificada do arquivo de configuração do aplicativo em relação ao contexto especificado.
GetSection(String, String, String)	Recupera a seção de configuração especificada usando o nome do site, o caminho virtual e o caminho da seção.
GetSection(HttpContext, String, Type)	Recupera a seção de configuração especificada usando o tipo de seção de configuração especificado do arquivo de configuração do aplicativo em relação ao contexto especificado.
GetSection(String, String, String, Type)	Recupera a seção de configuração especificada usando o nome do site, o caminho virtual, o caminho da seção e o tipo de tempo de execução.

GetSection(String)

Recupera a seção de configuração especificada do arquivo de configuração do aplicativo atual.

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

Parâmetros

sectionPath

String

O nome da seção de configuração.

Retornos

ConfigurationSection

O objeto de seção de configuração especificado ou null se a seção não existir.

Exceções

ConfigurationErrorsException

Um arquivo de configuração válido não pode ser carregado.

Comentários

Se a GetSection(String) sobrecarga for chamada de dentro de um aplicativo Web, ela retornará a seção do arquivo de configuração selecionado pelo sistema de acordo com a hierarquia de configuração do aplicativo Web.

Cuidado

Se o aplicativo usar um protocolo diferente de HTTP, você precisará usar a GetSection(HttpContext, String) sobrecarga ou GetSection(String, String, String, Type) , que cada um usa um nome de seção e um System.Web.HttpContext objeto em sua lista de parâmetros. Você deve especificar o HttpContext para habilitar o sistema a retornar as definições de configuração em um nível de hierarquia de configuração específico. No entanto, se o caminho de configuração especificado estiver fora do aplicativo GetSection atual e GetSection(String, String, String, Type) retornará as definições de configuração no nível do aplicativo para o aplicativo em execução no momento. Se você usar GetSection(String), que usa apenas um nome de seção, o sistema sempre tentará retornar as definições de configuração no nível do aplicativo.

Importante

O uso de GetSection(String) como uma operação em tempo de execução é limitado por restrições de segurança. Por exemplo, talvez você não consiga acessar ou modificar uma seção em tempo de execução.

GetSection(HttpContext, String)

Recupera a seção de configuração especificada do arquivo de configuração do aplicativo em relação ao contexto especificado.

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

Parâmetros

context

HttpContext

O HttpContext da solicitação atual.

sectionPath

String

O nome da seção de configuração.

Retornos

ConfigurationSection

O objeto de seção de configuração especificado ou null se a seção não existir.

Exceções

ConfigurationErrorsException

Um arquivo de configuração válido não pode ser carregado.

Comentários

Se a GetSection(HttpContext, String) sobrecarga for chamada de dentro de um aplicativo Web, ela retornará a seção do arquivo de configuração selecionado pelo sistema de acordo com o System.Web.HttpContext objeto do aplicativo Web.

Cuidado

Se o aplicativo usar um protocolo diferente de HTTP, você precisará usar a GetSection(HttpContext, String) sobrecarga ou GetSection(String, String, String, Type) , que cada um usa um nome de seção e um HttpContext na lista de parâmetros. Você deve especificar o HttpContext para habilitar o sistema a retornar as definições de configuração em um nível de hierarquia de configuração específico. No entanto, se o caminho de configuração especificado estiver fora do aplicativo GetSection(HttpContext, String) atual e GetSection(String, String, String, Type) retornará as definições de configuração no nível do aplicativo para o aplicativo em execução no momento. Se você usar a GetSection(String) sobrecarga, que usa apenas um nome de seção, o sistema sempre tentará retornar as definições de configuração no nível do aplicativo.

Importante

O uso de GetSection(HttpContext, String) como uma operação em tempo de execução é limitado por restrições de segurança. Por exemplo, talvez você não consiga acessar ou modificar uma seção em tempo de execução.

GetSection(String, String, String)

Recupera a seção de configuração especificada usando o nome do site, o caminho virtual e o caminho da seção.

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

Parâmetros

siteName

String

O nome do site.

virtualPath

String

O caminho virtual do arquivo Web.config.

sectionPath

String

O nome da seção de configuração.

Retornos

ConfigurationSection

Um objeto ConfigurationSection.

Exceções

ConfigurationErrorsException

Um arquivo de configuração válido não pode ser carregado.

ArgumentNullException

Um dos parâmetros passados para o método é null.

Comentários

A GetSection(String, String, String) sobrecarga retorna um ConfigurationSection objeto que representa a configuração do local solicitado. Esse método primeiro localiza o site solicitado no parâmetro e, em siteName seguida, localiza o arquivo Web.config no especificado virtualPath. GetSection(String, String, String) em seguida, pesquisa o arquivo de Web.config para a configuração sectionPathsolicitada.

Importante O uso de GetSection(String, String, String) como uma operação em tempo de execução é limitado por restrições de segurança. Por exemplo, talvez você não consiga acessar ou modificar uma seção em tempo de execução

GetSection(HttpContext, String, Type)

Recupera a seção de configuração especificada usando o tipo de seção de configuração especificado do arquivo de configuração do aplicativo em relação ao contexto especificado.

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

Parâmetros

context

HttpContext

O HttpContext objeto da solicitação atual.

sectionPath

String

O nome da seção de configuração.

sectionType

Type

O tipo de seção de configuração

Retornos

ConfigurationSection

O objeto de seção de configuração especificado ou null se a seção não existir.

Exceções

ConfigurationErrorsException

Um arquivo de configuração válido não pode ser carregado.

ArgumentNullException

Um dos parâmetros passados para o método é null.

InvalidOperationException

O valor do sectionType parâmetro não deriva da ConfigurationSection classe ou não fornece um construtor público.

Comentários

Se a GetSection(HttpContext, String, Type) sobrecarga for chamada de dentro de um aplicativo Web, ela retornará a seção do arquivo de configuração selecionado pelo sistema de acordo com o System.Web.HttpContext objeto do aplicativo Web, bem como os sectionPath parâmetros e sectionType fornecidos.

Cuidado

Se o aplicativo usar um protocolo diferente de HTTP, você precisará usar a GetSection(HttpContext, String) sobrecarga ou GetSection(String, String, String, Type) , que cada um usa um nome de seção e um HttpContext na lista de parâmetros. Você deve especificar o HttpContext para habilitar o sistema a retornar as definições de configuração em um nível de hierarquia de configuração específico. No entanto, se o caminho de configuração especificado estiver fora do aplicativo GetSection(HttpContext, String) atual e GetSection(String, String, String, Type) retornará as definições de configuração no nível do aplicativo para o aplicativo em execução no momento. Se você usar a GetSection(String) sobrecarga, que usa apenas um nome de seção, o sistema sempre tentará retornar as definições de configuração no nível do aplicativo.

Importante

O uso de GetSection(HttpContext, String, Type) como uma operação em tempo de execução é limitado por restrições de segurança. Por exemplo, talvez você não consiga acessar ou modificar uma seção em tempo de execução.

GetSection(String, String, String, Type)

Recupera a seção de configuração especificada usando o nome do site, o caminho virtual, o caminho da seção e o tipo de tempo de execução.

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

Parâmetros

siteName

String

O nome do site.

virtualPath

String

O caminho virtual do arquivo Web.config.

sectionPath

String

O nome da seção de configuração.

sectionType

Type

O tipo de tempo de execução da seção de configuração.

Retornos

ConfigurationSection

Um objeto ConfigurationSection.

Comentários

A GetSection(String, String, String, Type) sobrecarga retorna um ConfigurationSection objeto que representa a configuração do local solicitado. Esse método primeiro localiza o site solicitado no parâmetro e, em siteName seguida, localiza o arquivo Web.config no especificado virtualPath. GetSection(String, String, String, Type) em seguida, pesquisa o arquivo de Web.config para a configuração sectionPath solicitada que corresponde ao tipo de tempo de execução fornecido no sectionType parâmetro .

Importante

O uso de GetSection(String, String, String, Type) como uma operação em tempo de execução é limitado por restrições de segurança. Por exemplo, talvez você não consiga acessar ou modificar uma seção em tempo de execução.