WebConfigurationManager.GetSection WebConfigurationManager.GetSection WebConfigurationManager.GetSection WebConfigurationManager.GetSection Method

Definizione

Recupera la sezione di configurazione specificata dal file di configurazione predefinito dell'applicazione Web corrente.Retrieves the specified configuration section from the current Web application's default configuration file.

Overload

GetSection(String) GetSection(String) GetSection(String) GetSection(String)

Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione Web corrente.Retrieves the specified configuration section from the current Web application's configuration file.

GetSection(String, String) GetSection(String, String) GetSection(String, String) GetSection(String, String)

Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione Web nella posizione specificata.Retrieves the specified configuration section from the Web application's configuration file at the specified location.

GetSection(String) GetSection(String) GetSection(String) GetSection(String)

Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione Web corrente.Retrieves the specified configuration section from the current Web application's configuration file.

public:
 static System::Object ^ GetSection(System::String ^ sectionName);
public static object GetSection (string sectionName);
static member GetSection : string -> obj
Public Shared Function GetSection (sectionName As String) As Object

Parametri

sectionName
String String String String

Nome della sezione di configurazione.The configuration section name.

Restituisce

Oggetto sezione di configurazione specificata oppure null se la sezione non esiste.The specified configuration section object, or null if the section does not exist. Si ricorda che esistono restrizioni di sicurezza sull'utilizzo dell'oggetto GetSection(String) come operazione runtime.Remember that security restrictions exist on the use of GetSection(String) as a runtime operation. Ad esempio, potrebbe essere impossibile accedere a una sezione in fase di esecuzione per le modifiche.You might not be able to access a section at run time for modifications, for example.

Eccezioni

Impossibile caricare un file di configurazione valido.A valid configuration file could not be loaded.

Esempi

Gli esempi in questa sezione illustrano come accedere alle informazioni di configurazione con la GetSection (metodo).The examples in this section show how to access configuration information with the GetSection method.

Nell'esempio seguente mostra una sezione in cui è possibile accedere da un'applicazione Web o un'applicazione console.The following example shows a section that can be accessed from either a Web application or a console application.

Nota

In questo esempio illustra come usare il GetWebApplicationSection metodo per ottenere un ConfigurationSection oggetto da un file di configurazione.This example demonstrates how to use the GetWebApplicationSection method to get a ConfigurationSection object from a configuration file.


// Show how to use the GetSection(string). 
// to access the connectionStrings section.
static void GetConnectionStringsSection()
{

    // Get the connectionStrings section.
    ConnectionStringsSection connectionStringsSection =
        WebConfigurationManager.GetSection("connectionStrings")
        as ConnectionStringsSection;

    // Get the connectionStrings key,value pairs collection.
    ConnectionStringSettingsCollection connectionStrings =
        connectionStringsSection.ConnectionStrings;
   
    // Get the collection enumerator.
    IEnumerator connectionStringsEnum =
        connectionStrings.GetEnumerator();

    // Loop through the collection and 
    // display the connectionStrings key, value pairs.
    int i = 0;
    Console.WriteLine("[Display the connectionStrings]");
    while (connectionStringsEnum.MoveNext())
    {
        string name = connectionStrings[i].Name;
        Console.WriteLine("Name: {0} Value: {1}",
        name, connectionStrings[name]);
        i += 1;
    }

    Console.WriteLine();
}

' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("connectionStrings")
   
   ' Get the connectionStrings key,value pairs collection.
     Dim connectionStrings As ConnectionStringSettingsCollection = _
     connectionStringsSection.ConnectionStrings
   
   ' Get the collection enumerator.
     Dim connectionStringsEnum As IEnumerator = _
     connectionStrings.GetEnumerator()
   
   ' Loop through the collection and 
   ' display the connectionStrings key, value pairs.
   Dim i As Integer = 0
   Console.WriteLine("[Display the connectionStrings]")
   While connectionStringsEnum.MoveNext()
      Dim name As String = connectionStrings(i).Name
         Console.WriteLine("Name: {0} Value: {1}", _
         name, connectionStrings(name))
      i += 1
   End While
   
   Console.WriteLine()
End Sub 'GetSection1


Commenti

Se GetSection viene chiamato all'interno di un'applicazione Web, ottiene la sezione dal file di configurazione per il sistema in base alla gerarchia di configurazione dell'applicazione Web selezionata.If GetSection is called from within a Web application, it gets the section from the configuration file selected by the system according to the Web-application configuration hierarchy.

Attenzione

Se l'applicazione usa un protocollo diverso da HTTP, il GetSection overload che accetta un nome di sezione e un percorso nell'elenco dei parametri è quello da usare.If your application uses a different protocol than HTTP, the GetSection overload that takes both a section name and a path in its parameter list is the one to use. È necessario specificare il percorso del file di configurazione perché il sistema non può fare supposizioni sul livello di gerarchia di configurazione.You must specify the configuration file path because the system cannot make any assumptions about the configuration hierarchy level. Se si usa il GetSection overload che accetta solo un nome di sezione, il sistema tenterà sempre di restituire le impostazioni di configurazione a livello di applicazione.If you use the GetSection overload that takes only a section name, the system will always attempt to return the configuration settings at the application level. Si noti tuttavia che se il percorso specificato non è di fuori dell'applicazione corrente, l'overload che accetta un percorso restituirà anche le impostazioni di configurazione a livello di applicazione per l'applicazione attualmente in esecuzione.Note, though, that if its specified path is outside of the current application, the overload that takes a path will also return the application-level configuration settings for the currently running application.

È possibile chiamare GetSection all'interno di un'applicazione client.You could call GetSection from within a client application. In questo caso, ottiene la sezione predefinita dal file di configurazione selezionato dal sistema in base alla gerarchia di configurazione client.In this case, it gets the default section from the configuration file selected by the system according to the client configuration hierarchy. In genere, questo è il file Machine. config, a meno che non si dispone di una configurazione di mapping posto.Usually, this is the Machine.config file, unless you have a mapped configuration in place. Per il mapping di file di configurazione, fare riferimento ai metodi di mapping descritti di seguito.For mapping configuration files, refer to the mapping methods described next.

Nota

Il GetSection è un metodo di runtime che viene applicato alla sezione di un file di configurazione a livello di gerarchia in cui viene eseguita l'applicazione.The GetSection method is a run-time method that operates on the section of a configuration file at the hierarchy level in which the application runs. Per un'operazione di run-time, utilizzare GetSection invece.For a non-run-time operation, use GetSection instead. Questo metodo funziona della sezione specificata di un file di configurazione che è possibile ottenere usando uno dei metodi di overload per l'apertura di un file di configurazione OpenWebConfiguration.This method operates on the specified section of a configuration file that you obtain using one of the overloaded methods for opening a configuration file, OpenWebConfiguration.

Note per gli eredi

Il valore restituito, è necessario eseguire il cast al tipo di configurazione previsti prima dell'uso.The return value must be cast to the expected configuration type before use. Per evitare possibili eccezioni di cast, è consigliabile usare un'operazione cast condizionale, come il as operatore in c# o la funzione in Visual Basic.To avoid possible casting exceptions, you should use a conditional casting operation like the as operator in C# or the function in Visual Basic.

Vedi anche

GetSection(String, String) GetSection(String, String) GetSection(String, String) GetSection(String, String)

Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione Web nella posizione specificata.Retrieves the specified configuration section from the Web application's configuration file at the specified location.

public:
 static System::Object ^ GetSection(System::String ^ sectionName, System::String ^ path);
public static object GetSection (string sectionName, string path);
static member GetSection : string * string -> obj
Public Shared Function GetSection (sectionName As String, path As String) As Object

Parametri

sectionName
String String String String

Nome della sezione di configurazione.The configuration section name.

path
String String String String

Percorso del file di configurazione virtuale.The virtual configuration file path.

Restituisce

Oggetto sezione di configurazione specificata oppure null se la sezione non esiste.The specified configuration section object, or null if the section does not exist. Si ricorda che esistono restrizioni di sicurezza sull'utilizzo dell'oggetto GetSection(String, String) come operazione runtime.Remember that security restrictions exist on the use of GetSection(String, String) as a run-time operation. Si potrebbe non essere in grado di accedere a una sezione in fase di esecuzione per le modifiche, ad esempio.You might not be able to access a section at run time for modifications, for instance.

Eccezioni

Il metodo viene chiamato dall'esterno di un'applicazione Web.The method is called from outside a Web application.

Impossibile caricare un file di configurazione valido.A valid configuration file could not be loaded.

Esempi

Nell'esempio seguente viene illustrato come accedere alle informazioni di configurazione con la GetSection (metodo).The following example shows how to access configuration information with the GetSection method.

Nota

In questo esempio illustra come usare il GetSection metodo per ottenere un ConfigurationSection oggetto da un file di configurazione specificato.This example demonstrates how to use the GetSection method to get a ConfigurationSection object from a specified configuration file.


// Show the use of GetSection(string, string). 
// to access the connectionStrings section.
 static void GetSection2()
 {

     try
     {
         // Get the connectionStrings section for the 
         // specified Web app. This GetSection overload
         // can olny be called from within a Web application.
         ConnectionStringsSection connectionStringsSection =
             WebConfigurationManager.GetSection("connectionStrings",
             "/configTest") as ConnectionStringsSection;

         // Get the connectionStrings key,value pairs collection
         ConnectionStringSettingsCollection connectionStrings =
             connectionStringsSection.ConnectionStrings;

         // Get the collection enumerator.
         IEnumerator connectionStringsEnum =
             connectionStrings.GetEnumerator();

         // Loop through the collection and 
         // display the connectionStrings key, value pairs.
         int i = 0;
         Console.WriteLine("[Display connectionStrings]");
         while (connectionStringsEnum.MoveNext())
         {
             string name = connectionStrings[i].Name;
             Console.WriteLine("Name: {0} Value: {1}",
             name, connectionStrings[name]);
             i += 1;
         }
         Console.WriteLine();
     }

     catch (InvalidOperationException e)
     {
         string errorMsg = e.ToString();
         Console.WriteLine(errorMsg);
     }
 }

' Show the use of GetSection(string, string). 
' to access the connectionStrings section.
Shared Sub GetSection2()
   
   Try
      ' Get the connectionStrings section for the 
      ' specified Web app. This GetSection overload
      ' can olny be called from within a Web application.
         Dim connectionStringsSection As ConnectionStringsSection = _
         WebConfigurationManager.GetSection( _
         "connectionStrings", "/configTest")
      
      ' Get the connectionStrings key,value pairs collection
         Dim connectionStrings As ConnectionStringSettingsCollection = _
         connectionStringsSection.ConnectionStrings
      
      ' Get the collection enumerator.
         Dim connectionStringsEnum As IEnumerator = _
         connectionStrings.GetEnumerator()
      
      ' Loop through the collection and 
      ' display the connectionStrings key, value pairs.
      Dim i As Integer = 0
      Console.WriteLine("[Display connectionStrings]")
      While connectionStringsEnum.MoveNext()
         Dim name As String = connectionStrings(i).Name
             Console.WriteLine("Name: {0} Value: {1}", _
             name, connectionStrings(name))
         i += 1
      End While
      Console.WriteLine()
   
   Catch e As InvalidOperationException
      Dim errorMsg As String = e.ToString()
      Console.WriteLine(errorMsg)
   End Try
End Sub 'GetSection2


Commenti

Se GetSection viene chiamato all'interno di un'applicazione Web, ottiene la sezione dal file di configurazione definita dal percorso specificato nella gerarchia di configurazione.If GetSection is called from within a Web application, it gets the section from the configuration file defined by the specified path in the configuration hierarchy.

Attenzione

Se l'applicazione usa un protocollo diverso da HTTP, il GetSection overload che accetta un nome di sezione e un percorso nell'elenco dei parametri è quello da usare.If your application uses a different protocol than HTTP, the GetSection overload that takes both a section name and a path in its parameter list is the one to use. È necessario specificare il percorso del file di configurazione perché il sistema non può fare supposizioni sul livello di gerarchia di configurazione.You must specify the configuration file path because the system cannot make any assumptions about the configuration hierarchy level. Se si usa il GetSection overload che accetta solo un nome di sezione, il sistema tenterà sempre di restituire le impostazioni di configurazione a livello di applicazione.If you use the GetSection overload that takes only a section name, the system will always attempt to return the configuration settings at the application level. Si noti tuttavia che se il percorso specificato non è di fuori dell'applicazione corrente, l'overload che accetta un percorso restituirà anche le impostazioni di configurazione a livello di applicazione per l'applicazione attualmente in esecuzione.Note, though, that if its specified path is outside of the current application, the overload that takes a path will also return the application-level configuration settings for the currently running application.

Questo metodo non può essere chiamato dall'interno un'applicazione client.This method cannot be called from within a client application.

Se si desidera recuperare la sezione di configurazione dal file di configurazione che si trova al livello corrente Web dell'applicazione directory, usare il GetSection (metodo).If you want to retrieve the configuration section from the configuration file located at the current Web application directory level, use the GetSection method.

Nota

Il GetSection è un metodo in fase di esecuzione funziona nella sezione di un file di configurazione a livello di gerarchia in cui viene eseguita l'applicazione.The GetSection method is a run-time method operating on the section of a configuration file at the hierarchy level in which the application runs. Per un'operazione di run-time, utilizzare GetSection invece.For a non-run-time operation, use GetSection instead. Questo metodo funziona della sezione specificata di un file di configurazione che è possibile ottenere usando uno del open i metodi di file di configurazione.This method operates on the specified section of a configuration file that you obtain using one of the open configuration file methods.

Note per gli eredi

Il valore restituito, è necessario eseguire il cast al tipo di configurazione previsti prima dell'uso.The return value must be cast to the expected configuration type before use. Per evitare possibili eccezioni di cast, è consigliabile usare un'operazione cast condizionale, come il as operatore in c# o la funzione in Visual Basic.To avoid possible casting exceptions, you should use a conditional casting operation like the as operator in C# or the function in Visual Basic.

Vedi anche

Si applica a