WebConfigurationManager.GetSection Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.ConfigurationSectionPublic Shared Function GetSection (sectionPath As String) As ConfigurationSectionParâmetros
- sectionPath
- String
O nome da seção de configuração.
Retornos
O objeto de seção de configuração especificado ou null se a seção não existir.
Exceções
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.
Aplica-se a
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.ConfigurationSectionPublic Shared Function GetSection (context As HttpContext, sectionPath As String) As ConfigurationSectionParâmetros
- context
- HttpContext
O HttpContext da solicitação atual.
- sectionPath
- String
O nome da seção de configuração.
Retornos
O objeto de seção de configuração especificado ou null se a seção não existir.
Exceções
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.
Aplica-se a
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.ConfigurationSectionPublic Shared Function GetSection (siteName As String, virtualPath As String, sectionPath As String) As ConfigurationSectionParâ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
Um objeto ConfigurationSection.
Exceções
Um arquivo de configuração válido não pode ser carregado.
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
Aplica-se a
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.ConfigurationSectionPublic Shared Function GetSection (context As HttpContext, sectionPath As String, sectionType As Type) As ConfigurationSectionParâ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
O objeto de seção de configuração especificado ou null se a seção não existir.
Exceções
Um arquivo de configuração válido não pode ser carregado.
Um dos parâmetros passados para o método é null.
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.
Aplica-se a
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.ConfigurationSectionPublic Shared Function GetSection (siteName As String, virtualPath As String, sectionPath As String, sectionType As Type) As ConfigurationSectionParâ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
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.