WebConfigurationManager.GetWebApplicationSection(String) Methode

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

Parameter

Gibt zurück

Object

Das angegebene Konfigurationsabschnittsobjekt oder null, falls der Abschnitt nicht vorhanden ist, oder ein internes Objekt, falls der Zugriff auf den Abschnitt zur Laufzeit nicht möglich ist.

Ausnahmen

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie auf Konfigurationsinformationen mit der GetWebApplicationSection Methode zugreifen.

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

Hinweise

Wenn GetWebApplicationSection sie in einer Webanwendung aufgerufen wird, ruft sie den Abschnitt aus der vom System ausgewählten Konfigurationsdatei gemäß der Konfigurationshierarchie der Webanwendung ab.

Sie können von einer Clientanwendung aus aufrufen GetWebApplicationSection . In diesem Fall wird der Standardabschnitt aus der vom System ausgewählten Konfigurationsdatei gemäß der Clientkonfigurationshierarchie abgerufen. In der Regel ist dies die Machine.config Datei, es sei denn, Sie verfügen über eine zugeordnete Konfiguration. Informationen zum Zuordnen von Konfigurationsdateien finden Sie in den als nächstes beschriebenen Zuordnungsmethoden.

Hinweise für Vererber

Der Rückgabewert muss vor der Verwendung an den erwarteten Konfigurationstyp gecastt werden. Um mögliche Casting-Ausnahmen zu vermeiden, sollten Sie einen bedingten Castingvorgang wie den as Operator in C# verwenden.

Gilt für

Siehe auch

• ConfigurationSection