WebConfigurationManager.GetSection Methode

Definitie

Naamruimte:: System.Web.Configuration

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Haalt de opgegeven configuratiesectie op uit het standaardconfiguratiebestand van de huidige webtoepassing.

Overloads

Name	Description
GetSection(String)	Haalt de opgegeven configuratiesectie op uit het configuratiebestand van de huidige webtoepassing.
GetSection(String, String)	Haalt de opgegeven configuratiesectie op uit het configuratiebestand van de webtoepassing op de opgegeven locatie.

GetSection(String)

Haalt de opgegeven configuratiesectie op uit het configuratiebestand van de huidige webtoepassing.

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

Parameters

sectionName: String

De naam van de configuratiesectie.

Retouren

Object

Het opgegeven configuratiesectieobject of null als de sectie niet bestaat. Houd er rekening mee dat er beveiligingsbeperkingen bestaan voor het gebruik van GetSection(String) als runtimebewerking. Mogelijk hebt u tijdens runtime geen toegang tot een sectie voor wijzigingen.

Uitzonderingen

ConfigurationErrorsException

Er kan geen geldig configuratiebestand worden geladen.

Voorbeelden

In de voorbeelden in deze sectie ziet u hoe u toegang hebt tot configuratiegegevens met de GetSection methode.

In het volgende voorbeeld ziet u een sectie die toegankelijk is vanuit een webtoepassing of een consoletoepassing.

Note

In dit voorbeeld ziet u hoe u de GetWebApplicationSection methode gebruikt om een ConfigurationSection object op te halen uit een configuratiebestand.


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

Opmerkingen

Als GetSection deze wordt aangeroepen vanuit een webtoepassing, wordt de sectie opgehaald uit het configuratiebestand dat door het systeem is geselecteerd volgens de configuratiehiërarchie van de webtoepassing.

Caution

Als uw toepassing een ander protocol gebruikt dan HTTP, is de GetSection overbelasting die zowel een sectienaam als een pad in de parameterlijst gebruikt de overbelasting die moet worden gebruikt. U moet het pad naar het configuratiebestand opgeven omdat het systeem geen veronderstellingen kan maken over het niveau van de configuratiehiërarchie. Als u de GetSection overbelasting gebruikt die slechts een sectienaam gebruikt, probeert het systeem altijd de configuratie-instellingen op toepassingsniveau te retourneren. Houd er echter rekening mee dat als het opgegeven pad zich buiten de huidige toepassing bevindt, de overbelasting die een pad gebruikt, ook de configuratie-instellingen op toepassingsniveau retourneert voor de momenteel actieve toepassing.

U kunt vanuit een clienttoepassing bellen GetSection . In dit geval wordt de standaardsectie opgehaald uit het configuratiebestand dat door het systeem is geselecteerd volgens de clientconfiguratiehiërarchie. Dit is meestal het Machine.config bestand, tenzij u een toegewezen configuratie hebt. Raadpleeg de toewijzingsmethoden die hierna worden beschreven voor toewijzingsconfiguratiebestanden.

Note

De GetSection methode is een runtimemethode die werkt op het gedeelte van een configuratiebestand op het hiërarchieniveau waarin de toepassing wordt uitgevoerd. Gebruik in plaats daarvan voor een niet-runtimebewerking GetSection . Deze methode werkt op de opgegeven sectie van een configuratiebestand dat u verkrijgt met behulp van een van de overbelaste methoden voor het openen van een configuratiebestand, OpenWebConfiguration.

Notities voor overnemers

De retourwaarde moet worden gecast naar het verwachte configuratietype voordat u deze gebruikt. Als u mogelijke cast-uitzonderingen wilt voorkomen, moet u een voorwaardelijke cast-bewerking gebruiken, zoals de as operator in C#.

Zie ook

ConfigurationSection

Van toepassing op

GetSection(String, String)

Haalt de opgegeven configuratiesectie op uit het configuratiebestand van de webtoepassing op de opgegeven locatie.

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

Parameters

sectionName: String

De naam van de configuratiesectie.

path: String

Het pad naar het virtuele configuratiebestand.

Retouren

Object

Het opgegeven configuratiesectieobject of null als de sectie niet bestaat. Houd er rekening mee dat er beveiligingsbeperkingen bestaan voor het gebruik van GetSection(String, String) als runtimebewerking. Mogelijk hebt u tijdens runtime geen toegang tot een sectie voor wijzigingen.

Uitzonderingen

InvalidOperationException

De methode wordt aangeroepen van buiten een webtoepassing.

ConfigurationErrorsException

Er kan geen geldig configuratiebestand worden geladen.

Voorbeelden

In het volgende voorbeeld ziet u hoe u met de GetSection methode toegang hebt tot configuratiegegevens.

Note

In dit voorbeeld ziet u hoe u de GetSection methode gebruikt om een ConfigurationSection object op te halen uit een opgegeven configuratiebestand.


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

Opmerkingen

Als GetSection deze wordt aangeroepen vanuit een webtoepassing, wordt de sectie opgehaald uit het configuratiebestand dat is gedefinieerd door het opgegeven pad in de configuratiehiërarchie.

Caution

Deze methode kan niet worden aangeroepen vanuit een clienttoepassing.

Als u de configuratiesectie wilt ophalen uit het configuratiebestand op het huidige niveau van de webtoepassingsmap, gebruikt u de GetSection methode.

Note

De GetSection methode is een runtimemethode die wordt uitgevoerd in de sectie van een configuratiebestand op het niveau van de hiërarchie waarin de toepassing wordt uitgevoerd. Gebruik in plaats daarvan voor een niet-runtimebewerking GetSection . Deze methode werkt op de opgegeven sectie van een configuratiebestand dat u verkrijgt met behulp van een van de open configuratiebestandsmethoden.

Notities voor overnemers

Zie ook

ConfigurationSection

Van toepassing op

Feedback

Is deze pagina nuttig?