WebConfigurationManager.GetWebApplicationSection(String) Methode

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Ruft den angegebenen Konfigurationsabschnitt aus der Konfigurationsdatei der aktuellen Webanwendung ab.

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

sectionName

String

Der Konfigurationsabschnittsname.

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

ConfigurationErrorsException

Es konnte keine gültige Konfigurationsdatei geladen werden.

Beispiele

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

Hinweis

In diesem Beispiel wird veranschaulicht, wie Sie die GetWebApplicationSection Methode verwenden, um ein ConfigurationSection Objekt aus der Standardkonfigurationsdatei abzurufen.

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

Hinweis

Die GetWebApplicationSection Methode ist ein Laufzeitvorgang, der auf dem Abschnitt der Anwendungskonfigurationsdatei auf aktueller Ebene fungiert. Die GetSection Methode ist jedoch kein Laufzeitvorgang, sondern wirkt auf dem angegebenen Abschnitt, der über eine der Methoden zum Öffnen der Konfigurationsdateien abgerufen wird.

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.

Siehe auch

• ConfigurationSection