WebConfigurationManager.GetWebApplicationSection(String) Metodo

Definizione

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 ^ GetWebApplicationSection(System::String ^ sectionName);
public static object GetWebApplicationSection (string sectionName);
static member GetWebApplicationSection : string -> obj
Public Shared Function GetWebApplicationSection (sectionName As String) As Object

Parametri

sectionName
String

Nome della sezione di configurazione.The configuration section name.

Restituisce

Oggetto sezione di configurazione specificata oppure null se la sezione non esiste, oppure un oggetto interno se la sezione non risulta accessibile in fase di esecuzione.The specified configuration section object, or null if the section does not exist, or an internal object if the section is not accessible at run time.

Eccezioni

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 GetWebApplicationSection con il metodo.The following example shows how to access configuration information with the GetWebApplicationSection method.

Nota

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


// Show the use of GetWebApplicationSection(string). 
// to get the connectionStrings section.
 static void GetWebApplicationSection()
 {

     // Get the default connectionStrings section,
     ConnectionStringsSection connectionStringsSection =
         WebConfigurationManager.GetWebApplicationSection(
         "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 connectionStrings]");
     while (connectionStringsEnum.MoveNext())
     {
         string name = connectionStrings[i].Name;
         Console.WriteLine("Name: {0} Value: {1}",
         name, connectionStrings[name]);
         i += 1;
     }

     Console.WriteLine();
 }

' Show the use of GetWebApplicationSection(string). 
' to access the connectionStrings section.
Shared Sub GetWebApplicationSection()
   
   ' Get the default connectionStrings section,
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetWebApplicationSection( _
     "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 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


Commenti

Se GetWebApplicationSection viene chiamato dall'interno di un'applicazione Web, ottiene la sezione dal file di configurazione selezionato dal sistema in base alla gerarchia di configurazione dell'applicazione Web.If GetWebApplicationSection 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.

È possibile chiamare GetWebApplicationSection dall'interno di un'applicazione client.You could call GetWebApplicationSection 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, si tratta del file Machine. config, a meno che non si disponga di una configurazione mappata.Usually, this is the Machine.config file, unless you have a mapped configuration in place. Per i file di configurazione del mapping, fare riferimento ai metodi di mapping descritti di seguito.For mapping configuration files, refer to the mapping methods described next.

Nota

Il GetWebApplicationSection metodo è un'operazione in fase di esecuzione che agisce sulla sezione del file di configurazione dell'applicazione che si trova al livello corrente.The GetWebApplicationSection method is a run-time operation that acts on the section of the application configuration file located at the current level. Il GetSection metodo, tuttavia, non è un'operazione in fase di esecuzione, ma agisce sulla sezione specificata ottenuta tramite uno dei metodi per l'apertura dei file di configurazione.The GetSection method, however, is not a run-time operation but acts on the specified section obtained through one of the methods for opening the configuration files.

Note per gli eredi

È necessario eseguire il cast del valore restituito al tipo di configurazione previsto prima dell'utilizzo.The return value must be cast to the expected configuration type before use. Per evitare possibili eccezioni di cast, è consigliabile usare un'operazione di cast condizionale as come C# l'operatore in 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.

Si applica a

Vedi anche