WebConfigurationManager.GetSection Metodo

Definizione

Spazio dei nomi:

Microsoft.Web.Administration

Assembly:

Microsoft.Web.Administration.dll

Recupera la sezione di configurazione specificata dal file di configurazione predefinito dell'applicazione corrente.

Overload

GetSection(String)	Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione corrente.
GetSection(HttpContext, String)	Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione in relazione al contesto specificato.
GetSection(String, String, String)	Recupera la sezione di configurazione specificata usando il nome del sito Web, il percorso virtuale e il percorso della sezione.
GetSection(HttpContext, String, Type)	Recupera la sezione di configurazione specificata usando il tipo di sezione di configurazione specificato dal file di configurazione dell'applicazione in relazione al contesto specificato.
GetSection(String, String, String, Type)	Recupera la sezione di configurazione specificata usando il nome del sito Web, il percorso virtuale, il percorso della sezione e il tipo di runtime.

GetSection(String)

Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione corrente.

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

Parametri

sectionPath

String

Nome della sezione di configurazione.

Restituisce

ConfigurationSection

Oggetto sezione di configurazione specificata oppure null se la sezione non esiste.

Eccezioni

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

Commenti

Se l'overload GetSection(String) viene chiamato dall'interno di un'applicazione Web, restituisce la sezione dal file di configurazione selezionato dal sistema in base alla gerarchia di configurazione dell'applicazione Web.

Attenzione

Se l'applicazione usa un protocollo diverso da HTTP, è necessario usare o GetSection(String, String, String, Type) overload, che accettano sia un nome di sezione che un System.Web.HttpContext oggetto nell'elenco GetSection(HttpContext, String) dei parametri. È necessario specificare per HttpContext abilitare il sistema per restituire le impostazioni di configurazione a un determinato livello di gerarchia di configurazione. Tuttavia, se il percorso di configurazione specificato è esterno all'applicazione corrente e GetSection(String, String, String, Type) restituirà le impostazioni di configurazione a livello di applicazione per l'applicazione GetSection attualmente in esecuzione. Se si usa GetSection(String), che accetta solo un nome di sezione, il sistema tenterà sempre di restituire le impostazioni di configurazione a livello di applicazione.

Importante

L'uso di come operazione di runtime è limitato dalle restrizioni di GetSection(String) sicurezza. Ad esempio, potrebbe non essere possibile accedere o modificare una sezione in fase di esecuzione.

GetSection(HttpContext, String)

Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione in relazione al contesto specificato.

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

Parametri

context

HttpContext

Oggetto HttpContext della richiesta corrente.

sectionPath

String

Nome della sezione di configurazione.

Restituisce

ConfigurationSection

Oggetto sezione di configurazione specificata oppure null se la sezione non esiste.

Eccezioni

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

Commenti

Se l'overload GetSection(HttpContext, String) viene chiamato dall'interno di un'applicazione Web, restituisce la sezione dal file di configurazione selezionato dal sistema in base all'oggetto System.Web.HttpContext dell'applicazione Web.

Attenzione

Se l'applicazione usa un protocollo diverso da HTTP, è necessario usare l'overload oGetSection(String, String, String, Type), che accettano entrambi un nome di sezione e un HttpContext oggetto nell'elenco GetSection(HttpContext, String) dei parametri. È necessario specificare per HttpContext abilitare il sistema per restituire le impostazioni di configurazione a un determinato livello di gerarchia di configurazione. Tuttavia, se il percorso di configurazione specificato è esterno all'applicazione corrente e GetSection(String, String, String, Type) restituirà le impostazioni di configurazione a livello di applicazione per l'applicazione GetSection(HttpContext, String) attualmente in esecuzione. Se si usa l'overload GetSection(String) , che accetta solo un nome di sezione, il sistema tenterà sempre di restituire le impostazioni di configurazione a livello di applicazione.

Importante

L'uso di come operazione di runtime è limitato dalle restrizioni di GetSection(HttpContext, String) sicurezza. Ad esempio, potrebbe non essere possibile accedere o modificare una sezione in fase di esecuzione.

GetSection(String, String, String)

Recupera la sezione di configurazione specificata usando il nome del sito Web, il percorso virtuale e il percorso della sezione.

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

Parametri

siteName

String

Nome del sito Web.

virtualPath

String

Percorso virtuale del file di Web.config.

sectionPath

String

Nome della sezione di configurazione.

Restituisce

ConfigurationSection

Un oggetto ConfigurationSection.

Eccezioni

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

ArgumentNullException

Uno dei parametri passati al metodo è null.

Commenti

L'overload GetSection(String, String, String) restituisce un ConfigurationSection oggetto che rappresenta la configurazione per la posizione richiesta. Questo metodo trova prima il sito Web richiesto nel siteName parametro e quindi trova il file Web.config nell'oggetto specificato virtualPath. GetSection(String, String, String) cerca quindi il file di Web.config per la configurazione sectionPathrichiesta.

Importante L'uso di come operazione di runtime è limitato dalle restrizioni di GetSection(String, String, String) sicurezza. Ad esempio, potrebbe non essere possibile accedere o modificare una sezione in fase di esecuzione

GetSection(HttpContext, String, Type)

Recupera la sezione di configurazione specificata usando il tipo di sezione di configurazione specificato dal file di configurazione dell'applicazione in relazione al contesto specificato.

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

Parametri

context

HttpContext

HttpContext Oggetto della richiesta corrente.

sectionPath

String

Nome della sezione di configurazione.

sectionType

Type

Tipo di sezione di configurazione

Restituisce

ConfigurationSection

Oggetto sezione di configurazione specificata oppure null se la sezione non esiste.

Eccezioni

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

ArgumentNullException

Uno dei parametri passati al metodo è null.

InvalidOperationException

Il valore del sectionType parametro non deriva dalla ConfigurationSection classe o non fornisce un costruttore pubblico.

Commenti

Se l'overload GetSection(HttpContext, String, Type) viene chiamato dall'interno di un'applicazione Web, restituisce la sezione dal file di configurazione selezionato dal sistema in base all'oggetto System.Web.HttpContext dell'applicazione Web e ai sectionPath parametri e sectionType forniti.

Attenzione

Se l'applicazione usa un protocollo diverso da HTTP, è necessario usare l'overload oGetSection(String, String, String, Type), che accettano entrambi un nome di sezione e un HttpContext oggetto nell'elenco GetSection(HttpContext, String) dei parametri. È necessario specificare per HttpContext abilitare il sistema per restituire le impostazioni di configurazione a un determinato livello di gerarchia di configurazione. Tuttavia, se il percorso di configurazione specificato è esterno all'applicazione corrente e GetSection(String, String, String, Type) restituirà le impostazioni di configurazione a livello di applicazione per l'applicazione GetSection(HttpContext, String) attualmente in esecuzione. Se si usa l'overload GetSection(String) , che accetta solo un nome di sezione, il sistema tenterà sempre di restituire le impostazioni di configurazione a livello di applicazione.

Importante

L'uso di come operazione di runtime è limitato dalle restrizioni di GetSection(HttpContext, String, Type) sicurezza. Ad esempio, potrebbe non essere possibile accedere o modificare una sezione in fase di esecuzione.

GetSection(String, String, String, Type)

Recupera la sezione di configurazione specificata usando il nome del sito Web, il percorso virtuale, il percorso della sezione e il tipo di runtime.

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

Parametri

siteName

String

Nome del sito Web.

virtualPath

String

Percorso virtuale del file di Web.config.

sectionPath

String

Nome della sezione di configurazione.

sectionType

Type

Tipo di runtime della sezione di configurazione.

Restituisce

ConfigurationSection

Un oggetto ConfigurationSection.

Commenti

L'overload GetSection(String, String, String, Type) restituisce un ConfigurationSection oggetto che rappresenta la configurazione per la posizione richiesta. Questo metodo trova prima il sito Web richiesto nel siteName parametro e quindi trova il file Web.config nell'oggetto specificato virtualPath. GetSection(String, String, String, Type) cerca quindi il file di Web.config per la configurazione sectionPath richiesta corrispondente al tipo di runtime fornito nel sectionType parametro.

Importante

L'uso di come operazione di runtime è limitato dalle restrizioni di GetSection(String, String, String, Type) sicurezza. Ad esempio, potrebbe non essere possibile accedere o modificare una sezione in fase di esecuzione.