WebConfigurationManager.GetSection Metoda

Definice

Obor názvů:: System.Web.Configuration

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Přetížení

Name	Description
GetSection(String)	Načte zadaný oddíl konfigurace z konfiguračního souboru aktuální webové aplikace.
GetSection(String, String)	Načte zadaný oddíl konfigurace z konfiguračního souboru webové aplikace v zadaném umístění.

GetSection(String)

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

public:
 static System::Object ^ GetSection(System::String ^ sectionName);

public static object GetSection(string sectionName);

static member GetSection : string -> obj

Public Shared Function GetSection (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. Mějte na paměti, že existují omezení zabezpečení pro použití GetSection(String) jako operace modulu runtime. Možná nebudete mít přístup k oddílu za běhu, například pro úpravy.

Výjimky

ConfigurationErrorsException

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

Příklady

Příklady v této části ukazují, jak získat přístup k informacím o konfiguraci pomocí GetSection metody.

Následující příklad ukazuje část, ke které lze přistupovat z webové aplikace nebo konzolové aplikace.

Note

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


// Show how to use the GetSection(string).
// to access the connectionStrings section.
static void GetConnectionStringsSection()
{

    // Get the connectionStrings section.
    ConnectionStringsSection connectionStringsSection =
        WebConfigurationManager.GetSection("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 the connectionStrings]");
    while (connectionStringsEnum.MoveNext())
    {
        string name = connectionStrings[i].Name;
        Console.WriteLine("Name: {0} Value: {1}",
        name, connectionStrings[name]);
        i += 1;
    }

    Console.WriteLine();
}

' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("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 the 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 GetSection je volána z webové aplikace, získá oddíl z konfiguračního souboru vybraného systémem podle hierarchie konfigurace webové aplikace.

Caution

Pokud vaše aplikace používá jiný protokol než HTTP, přetížení, které přebírá název oddílu i cestu v seznamu parametrů, je ten, GetSection který se má použít. Musíte zadat cestu ke konfiguračnímu souboru, protože systém nemůže provést žádné předpoklady o úrovni hierarchie konfigurace. Pokud použijete GetSection přetížení, které přebírá pouze název oddílu, systém se vždy pokusí vrátit nastavení konfigurace na úrovni aplikace. Upozorňujeme ale, že pokud je zadaná cesta mimo aktuální aplikaci, přetížení, které přebírá cestu, vrátí také nastavení konfigurace na úrovni aplikace pro aktuálně spuštěnou aplikaci.

Můžete volat GetSection 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

Tato GetSection metoda je metoda za běhu, která pracuje v části konfiguračního souboru na úrovni hierarchie, ve které aplikace běží. Pro neběžnou operaci použijte GetSection místo toho. Tato metoda pracuje se zadaným oddílem konfiguračního souboru, který získáte pomocí jedné z přetížených metod pro otevření konfiguračního souboru, OpenWebConfiguration.

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

Platí pro

GetSection(String, String)

Načte zadaný oddíl konfigurace z konfiguračního souboru webové aplikace v zadaném umístění.

public:
 static System::Object ^ GetSection(System::String ^ sectionName, System::String ^ path);

public static object GetSection(string sectionName, string path);

static member GetSection : string * string -> obj

Public Shared Function GetSection (sectionName As String, path As String) As Object

Parametry

sectionName: String

Název oddílu konfigurace.

path: String

Cesta k virtuálnímu konfiguračnímu souboru.

Návraty

Object

Zadaný objekt oddílu konfigurace nebo null pokud oddíl neexistuje. Mějte na paměti, že existují omezení zabezpečení pro použití GetSection(String, String) jako operace za běhu. Možná nebudete mít přístup k oddílu za běhu pro úpravy, například.

Výjimky

InvalidOperationException

Metoda je volána mimo webovou aplikaci.

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í GetSection metody.

Note

Tento příklad ukazuje, jak pomocí GetSection metody získat ConfigurationSection objekt ze zadaného konfiguračního souboru.


// Show the use of GetSection(string, string).
// to access the connectionStrings section.
 static void GetSection2()
 {

     try
     {
         // Get the connectionStrings section for the
         // specified Web app. This GetSection overload
         // can olny be called from within a Web application.
         ConnectionStringsSection connectionStringsSection =
             WebConfigurationManager.GetSection("connectionStrings",
             "/configTest") 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();
     }

     catch (InvalidOperationException e)
     {
         string errorMsg = e.ToString();
         Console.WriteLine(errorMsg);
     }
 }

' Show the use of GetSection(string, string). 
' to access the connectionStrings section.
Shared Sub GetSection2()
   
   Try
      ' Get the connectionStrings section for the 
      ' specified Web app. This GetSection overload
      ' can olny be called from within a Web application.
         Dim connectionStringsSection As ConnectionStringsSection = _
         WebConfigurationManager.GetSection( _
         "connectionStrings", "/configTest")
      
      ' 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()
   
   Catch e As InvalidOperationException
      Dim errorMsg As String = e.ToString()
      Console.WriteLine(errorMsg)
   End Try
End Sub

Poznámky

Pokud GetSection je volána z webové aplikace, získá oddíl z konfiguračního souboru definovaného zadanou cestou v hierarchii konfigurace.

Caution

Tuto metodu nelze volat z klientské aplikace.

Pokud chcete načíst oddíl konfigurace z konfiguračního souboru umístěného na aktuální úrovni adresáře webové aplikace, použijte metodu GetSection .

Note

Metoda GetSection je metoda za běhu, která funguje v části konfiguračního souboru na úrovni hierarchie, ve které se aplikace spouští. Pro neběžnou operaci použijte GetSection místo toho. Tato metoda funguje v zadané části konfiguračního souboru, který získáte pomocí jedné z metod konfiguračního open souboru.

Poznámky pro dědice

Viz také

ConfigurationSection

Platí pro

Váš názor

Byla tato stránka užitečná?