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 pomocí metody získat přístup k informacím GetWebApplicationSection o konfiguraci.

Poznámka

Tento příklad ukazuje, jak použít metodu GetWebApplicationSection k získání ConfigurationSection objektu 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 soubor Machine.config, pokud nemáte namapovanou konfiguraci. Informace o mapování konfiguračních souborů najdete v dalších metodách mapování.

Poznámka

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ém oddílu získaném 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řetypovaná na očekávaný typ konfigurace. Pokud chcete zabránit 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