WebConfigurationManager.GetWebApplicationSection(String) Metod

Definition

Namnområde:
System.Web.Configuration
Sammansättning:
System.Web.dll

Hämtar det angivna konfigurationsavsnittet från det aktuella webbprogrammets konfigurationsfil.

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

Parametrar

sectionName
String

Namnet på konfigurationsavsnittet.

Returer

Object

Det angivna konfigurationsavsnittsobjektet, eller null om avsnittet inte finns, eller ett internt objekt om avsnittet inte är tillgängligt vid körning.

Undantag

ConfigurationErrorsException

Det gick inte att läsa in en giltig konfigurationsfil.

Exempel

I följande exempel visas hur du kommer åt konfigurationsinformation med GetWebApplicationSection -metoden.

Note

Det här exemplet visar hur du använder GetWebApplicationSection metoden för att hämta ett ConfigurationSection objekt från standardkonfigurationsfilen.


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

Kommentarer

Om GetWebApplicationSection anropas inifrån ett webbprogram hämtas avsnittet från konfigurationsfilen som valts av systemet enligt konfigurationshierarkin för webbprogram.

Du kan anropa GetWebApplicationSection inifrån ett klientprogram. I det här fallet hämtas standardavsnittet från konfigurationsfilen som valts av systemet enligt klientkonfigurationshierarkin. Detta är vanligtvis den Machine.config filen, såvida du inte har en mappad konfiguration på plats. För mappning av konfigurationsfiler, se de mappningsmetoder som beskrivs härnäst.

Note

Metoden GetWebApplicationSection är en körningsåtgärd som fungerar i avsnittet i programkonfigurationsfilen som finns på den aktuella nivån. Metoden GetSection är dock inte en körningsåtgärd utan fungerar i det angivna avsnittet som hämtas via någon av metoderna för att öppna konfigurationsfilerna.

Anteckningar till arvingar

Returvärdet måste omvandlas till den förväntade konfigurationstypen innan det används. För att undvika möjliga undantag för gjutning bör du använda en villkorlig gjutningsåtgärd som operatorn as i C#.

Gäller för

Se även