WebConfigurationManager Classe

Définition

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Héritage

Object

WebConfigurationManager

Exemples

L’exemple suivant montre comment accéder aux informations de configuration avec le

MéthodeGetSection .

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

La WebConfigurationManager classe vous permet d’accéder aux informations de l’ordinateur et de l’application.

L’utilisation WebConfigurationManager est la méthode recommandée pour utiliser les fichiers de configuration liés aux applications web. Pour les applications clientes, utilisez la ConfigurationManager classe .

Votre application peut étendre les System.Configuration types ou les utiliser directement pour gérer les informations de configuration, comme expliqué dans la liste suivante :

• Handling configuration. Pour gérer les informations de configuration à l’aide des types standard, vous utilisez l’une des approches suivantes :

  • Accessing a section. Pour accéder aux informations de configuration de votre application, vous devez utiliser l’une GetSection des méthodes fournies par WebConfigurationManager. Pour <appSettings> et <connectionStrings>, vous utilisez les AppSettings propriétés et ConnectionStrings . Ces méthodes effectuent des opérations en lecture seule, utilisent une seule instance mise en cache de la configuration et prennent en charge le multithread.

  • Accessing configuration files. Votre application peut lire et écrire des paramètres de configuration à n’importe quel niveau, pour elle-même ou pour d’autres applications ou ordinateurs, localement ou à distance. Vous utilisez l’une des open méthodes fournies par WebConfigurationManager. Ces méthodes retournent un Configuration objet, qui fournit à son tour les méthodes et propriétés requises pour gérer les fichiers de configuration sous-jacents. Ces méthodes effectuent des opérations de lecture ou d’écriture et recréent les données de configuration chaque fois qu’un fichier est ouvert.

  • Advanced configuration. Une gestion de configuration plus avancée est fournie par les types SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformationConfigurationSectionGroup, et ConfigurationSectionGroupCollection.

• Extending configuration standard types. Vous pouvez également fournir vos éléments de configuration personnalisés en étendant les types de configuration standard tels que ConfigurationElement, ConfigurationElementCollection, ConfigurationPropertyet ConfigurationSection à l’aide d’un modèle programmatique ou à attributs. Reportez-vous à la ConfigurationSection classe pour obtenir un exemple d’extension d’un type de configuration standard par programmation. Reportez-vous à la ConfigurationElement classe pour obtenir un exemple d’extension d’un type de configuration standard à l’aide du modèle à attributs.

Notes pour les héritiers

La Configuration classe autorise l’accès par programmation pour la modification des fichiers de configuration. Vous utilisez l’une des méthodes ouvertes fournies par WebConfigurationManager. Ces méthodes retournent un Configuration objet, qui fournit à son tour les méthodes et propriétés requises pour gérer les fichiers de configuration sous-jacents. Vous pouvez accéder à ces fichiers pour la lecture ou l’écriture comme suit :

Vous utilisez GetSection(String) ou GetSectionGroup(String) pour lire les informations de configuration. Notez que l’utilisateur ou le processus qui lit doit disposer des autorisations suivantes :

• Autorisation de lecture sur le fichier de configuration au niveau de la hiérarchie de configuration actuelle.

• Autorisations de lecture sur tous les fichiers de configuration parent.

Si votre application a besoin d’un accès en lecture seule à sa propre configuration, il est recommandé d’utiliser les GetSection méthodes . Ces méthodes permettent d’accéder aux valeurs de configuration mises en cache pour l’application actuelle, qui offre de meilleures performances que la Configuration classe .

Remarque : Si vous utilisez une méthode statique GetSection qui prend un path paramètre, le paramètre path doit faire référence à l’application dans laquelle le code est en cours d’exécution ; sinon, le paramètre est ignoré et les informations de configuration de l’application en cours d’exécution sont retournées.

Vous utilisez l’une des méthodes pour écrire des Save informations de configuration. Notez que l’utilisateur ou le processus qui écrit doit disposer des autorisations suivantes :

• Autorisation d’écriture sur le fichier de configuration et le répertoire au niveau de la hiérarchie de configuration actuelle.

• Autorisations de lecture sur tous les fichiers de configuration.

Propriétés

Méthodes

S’applique à

Voir aussi

• Configuration
• ConfigurationManager
• Vue d’ensemble de la configuration ASP.NET