WebConfigurationManager.GetWebApplicationSection(String) Metódus

Definíció

Névtér:

System.Web.Configuration

Szerelvény:

System.Web.dll

Lekéri a megadott konfigurációs szakaszt az aktuális webalkalmazás konfigurációs fájljából.

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

Paraméterek

sectionName

String

A konfigurációs szakasz neve.

Válaszok

Object

A megadott konfigurációs szakaszobjektum, vagy null ha a szakasz nem létezik, vagy egy belső objektum, ha a szakasz futásidőben nem érhető el.

Kivételek

ConfigurationErrorsException

Érvényes konfigurációs fájl nem tölthető be.

Példák

Az alábbi példa bemutatja, hogyan férhet hozzá a konfigurációs adatokhoz a GetWebApplicationSection módszerrel.

Note

Ez a példa bemutatja, hogyan lehet a GetWebApplicationSection metódussal objektumot ConfigurationSection lekérni az alapértelmezett konfigurációs fájlból.

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

Megjegyzések

Ha GetWebApplicationSection egy webalkalmazásból hívjuk meg, a szakaszt a rendszer által a webalkalmazás konfigurációs hierarchiája szerint kiválasztott konfigurációs fájlból kapja meg.

Egy ügyfélalkalmazásból is hívhat GetWebApplicationSection . Ebben az esetben lekéri az alapértelmezett szakaszt a rendszer által az ügyfélkonfigurációs hierarchia alapján kiválasztott konfigurációs fájlból. Általában ez a Machine.config fájl, hacsak nincs leképezett konfigurációja. A konfigurációs fájlok leképezéséhez tekintse meg a következő ismertetett leképezési módszereket.

Note

A GetWebApplicationSection metódus egy futásidejű művelet, amely az alkalmazáskonfigurációs fájl aktuális szinten található szakaszán működik. A GetSection metódus azonban nem futásidejű művelet, hanem a konfigurációs fájlok megnyitásának egyik metódusával kapott megadott szakaszon működik.

Megjegyzések az öröklőkhöz

A visszatérési értéket használat előtt a várt konfigurációs típusra kell leadni. A lehetséges kiosztási kivételek elkerülése érdekében olyan feltételes öntési műveletet kell használnia, mint a as C# operátora.

Lásd még

• ConfigurationSection