WebConfigurationManager.GetSection Méthode

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

Paramètres

Retours

Objet de section de configuration spécifié ou null si la section n’existe pas. N’oubliez pas que les restrictions de sécurité existent sur l’utilisation en GetSection(String) tant qu’opération d’exécution. Vous ne pouvez peut-être pas accéder à une section au moment de l’exécution pour les modifications, par exemple.

Exceptions

Exemples

Les exemples de cette section montrent comment accéder aux informations de configuration avec la GetSection méthode.

L’exemple suivant montre une section accessible à partir d’une application web ou d’une application console.

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

Remarques

Si GetSection elle est appelée à partir d’une application web, elle obtient la section du fichier de configuration sélectionné par le système en fonction de la hiérarchie de configuration de l’application web.

Vous pouvez appeler GetSection à partir d’une application cliente. Dans ce cas, il obtient la section par défaut du fichier de configuration sélectionné par le système en fonction de la hiérarchie de configuration du client. En règle générale, il s’agit du fichier Machine.config, sauf si vous avez une configuration mappée en place. Pour les fichiers de configuration de mappage, reportez-vous aux méthodes de mappage décrites ci-dessous.

Notes pour les héritiers

La valeur de retour doit être convertie en type de configuration attendu avant l’utilisation. Pour éviter les exceptions de cast possibles, vous devez utiliser une opération de cast conditionnel comme l’opérateur as en C#.

Voir aussi

• ConfigurationSection

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

Paramètres

Retours

Objet de section de configuration spécifié ou null si la section n’existe pas. N’oubliez pas que les restrictions de sécurité existent sur l’utilisation en GetSection(String, String) tant qu’opération d’exécution. Vous ne pourrez peut-être pas accéder à une section au moment de l’exécution pour les modifications, par exemple.

Exceptions

Exemples

L’exemple suivant montre comment accéder aux informations de configuration avec la GetSection méthode.

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

Remarques

Si GetSection elle est appelée à partir d’une application web, elle obtient la section du fichier de configuration défini par le chemin spécifié dans la hiérarchie de configuration.

Cette méthode ne peut pas être appelée à partir d’une application cliente.

Si vous souhaitez récupérer la section de configuration à partir du fichier de configuration situé au niveau du répertoire d’application web actuel, utilisez la GetSection méthode.

Notes pour les héritiers

La valeur de retour doit être convertie en type de configuration attendu avant l’utilisation. Pour éviter les exceptions de cast possibles, vous devez utiliser une opération de cast conditionnel comme l’opérateur as en C#.

Voir aussi

• ConfigurationSection