WebConfigurationManager.GetWebApplicationSection(String) Metodo

Definizione

Spazio dei nomi:

System.Web.Configuration

Assembly:

System.Web.dll

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

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.

Restituisce

Object

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.

Eccezioni

ConfigurationErrorsException

Impossibile caricare un file di configurazione valido.

Esempio

Nell'esempio seguente viene illustrato come accedere alle informazioni di configurazione con il GetWebApplicationSection metodo .

Nota

In questo esempio viene illustrato come usare il GetWebApplicationSection metodo per ottenere un ConfigurationSection oggetto dal file di configurazione predefinito.

// 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.

È possibile chiamare GetWebApplicationSection da un'applicazione client. In questo caso, ottiene la sezione predefinita dal file di configurazione selezionato dal sistema in base alla gerarchia di configurazione client. In genere, si tratta del file di Machine.config, a meno che non sia presente una configurazione mappata. Per i file di configurazione di mapping, vedere i metodi di mapping descritti di seguito.

Nota

Il GetWebApplicationSection metodo è un'operazione di runtime che agisce sulla sezione del file di configurazione dell'applicazione che si trova a livello corrente. Il GetSection metodo, tuttavia, non è un'operazione di runtime, ma agisce sulla sezione specificata ottenuta tramite uno dei metodi per l'apertura dei file di configurazione.

Note per gli eredi

È necessario eseguire il cast del valore restituito al tipo di configurazione previsto prima dell'uso. Per evitare possibili eccezioni di cast, è consigliabile usare un'operazione di cast condizionale come l'operatore as in C#.

Vedi anche

• ConfigurationSection