WebConfigurationManager.GetWebApplicationSection(String) Méthode

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

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

Exemples

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

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

S’applique à

Voir aussi

• ConfigurationSection