WebConfigurationManager.GetWebApplicationSection(String) Méthode

Définition

Espace de noms:

System.Web.Configuration

Assembly:

System.Web.dll

Récupère la section de configuration spécifiée à partir du fichier de configuration de l'application Web en cours.

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

Paramètres

sectionName

String

Nom de la section de configuration.

Retours

Object

Objet de la section de configuration spécifiée ou null si la section n'existe pas, ou objet interne si la section n'est pas accessible au moment de l'exécution.

Exceptions

ConfigurationErrorsException

Un fichier de configuration valide n'a pas pu être chargé.

Exemples

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

Notes

Cet exemple montre comment utiliser la GetWebApplicationSection méthode pour obtenir un ConfigurationSection objet à partir du fichier de configuration par défaut.

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

Remarques

Si GetWebApplicationSection 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 GetWebApplicationSection à 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

La GetWebApplicationSection méthode est une opération d’exécution qui agit sur la section du fichier de configuration de l’application située au niveau actuel. Toutefois, la GetSection méthode n’est pas une opération d’exécution, mais agit sur la section spécifiée obtenue via l’une des méthodes permettant d’ouvrir les fichiers de configuration.

Notes pour les héritiers

La valeur de retour doit être castée vers le 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