WebConfigurationManager.GetWebApplicationSection(String) Metoda

Definice

Obor názvů:

System.Web.Configuration

Sestavení:

System.Web.dll

Načte zadaný oddíl konfigurace z konfiguračního souboru aktuální webové aplikace.

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

Parametry

sectionName

String

Název oddílu konfigurace.

Návraty

Object

Zadaný objekt oddílu konfigurace nebo null pokud oddíl neexistuje, nebo interní objekt, pokud oddíl není přístupný za běhu.

Výjimky

ConfigurationErrorsException

Nelze načíst platný konfigurační soubor.

Příklady

Následující příklad ukazuje, jak získat přístup k informacím o konfiguraci pomocí GetWebApplicationSection metody.

Note

Tento příklad ukazuje, jak pomocí GetWebApplicationSection metody získat ConfigurationSection objekt z výchozího konfiguračního souboru.

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

Poznámky

Pokud GetWebApplicationSection je volána z webové aplikace, získá oddíl z konfiguračního souboru vybraného systémem podle hierarchie konfigurace webové aplikace.

Můžete volat GetWebApplicationSection z klientské aplikace. V tomto případě získá výchozí oddíl z konfiguračního souboru vybraného systémem podle hierarchie konfigurace klienta. Obvykle se jedná o Machine.config soubor, pokud nemáte namapovanou konfiguraci. Informace o mapování konfiguračních souborů najdete v následujících metodách mapování.

Note

Metoda GetWebApplicationSection je operace za běhu, která funguje v části konfiguračního souboru aplikace umístěného na aktuální úrovni. Metoda GetSection však není operace za běhu, ale funguje na zadané části získané prostřednictvím jedné z metod pro otevření konfiguračních souborů.

Poznámky pro dědice

Návratová hodnota musí být před použitím přetypován na očekávaný typ konfigurace. Abyste se vyhnuli možným výjimkám přetypování, měli byste použít podmíněnou operaci přetypování, jako je as operátor v jazyce C#.

Viz také

• ConfigurationSection