Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

WebConfigurationManager classe

 

Date de publication : novembre 2016

Fournit l’accès aux fichiers de configuration qui s’appliquent aux applications Web.

Espace de noms:   System.Web.Configuration
Assembly:  System.Web (dans System.Web.dll)

System.Object
  System.Web.Configuration.WebConfigurationManager

public static class WebConfigurationManager

NomDescription
System_CAPS_pubpropertySystem_CAPS_staticAppSettings

Obtient les paramètres de l’application du site Web.

System_CAPS_pubpropertySystem_CAPS_staticConnectionStrings

Obtient les chaînes de connexion du site Web.

NomDescription
System_CAPS_pubmethodSystem_CAPS_staticGetSection(String)

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

System_CAPS_pubmethodSystem_CAPS_staticGetSection(String, String)

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

System_CAPS_pubmethodSystem_CAPS_staticGetWebApplicationSection(String)

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

System_CAPS_pubmethodSystem_CAPS_staticOpenMachineConfiguration()

Ouvre le fichier de configuration de l’ordinateur sur l’ordinateur actuel en tant qu’un Configuration objet à autoriser lire ou écrire des opérations.

System_CAPS_pubmethodSystem_CAPS_staticOpenMachineConfiguration(String)

Ouvre le fichier de configuration de l’ordinateur sur l’ordinateur actuel en tant qu’un Configuration objet à autoriser lire ou écrire des opérations.

System_CAPS_pubmethodSystem_CAPS_staticOpenMachineConfiguration(String, String)

Ouvre le fichier de configuration de l’ordinateur spécifié sur le serveur spécifié en tant qu’un Configuration objet à autoriser lire ou écrire des opérations.

System_CAPS_pubmethodSystem_CAPS_staticOpenMachineConfiguration(String, String, IntPtr)

Ouvre le fichier de configuration de l’ordinateur spécifié sur le serveur spécifié en tant qu’un Configuration de l’objet, à l’aide du contexte de sécurité spécifié pour autoriser la lecture ou écriture.

System_CAPS_pubmethodSystem_CAPS_staticOpenMachineConfiguration(String, String, String, String)

Ouvre le fichier de configuration de l’ordinateur spécifié sur le serveur spécifié en tant qu’un Configuration de l’objet, à l’aide du contexte de sécurité spécifié pour autoriser la lecture ou écriture.

System_CAPS_pubmethodSystem_CAPS_staticOpenMappedMachineConfiguration(ConfigurationFileMap)

Ouvre le fichier de configuration de l’ordinateur en tant qu’un Configuration de l’objet, à l’aide du mappage de fichiers spécifié pour permettre la lecture ou les opérations d’écriture.

System_CAPS_pubmethodSystem_CAPS_staticOpenMappedMachineConfiguration(ConfigurationFileMap, String)

Ouvre le fichier de configuration de l’ordinateur en tant qu’un Configuration à l’aide du mappage de fichiers spécifié et l’emplacement pour autoriser la lecture ou écriture.

System_CAPS_pubmethodSystem_CAPS_staticOpenMappedWebConfiguration(WebConfigurationFileMap, String)

Ouvre le fichier de configuration d’application Web spécifié en tant qu’un Configuration à l’aide du mappage de fichiers spécifié et le chemin d’accès virtuel pour permettre la lecture ou les opérations d’écriture de l’objet.

System_CAPS_pubmethodSystem_CAPS_staticOpenMappedWebConfiguration(WebConfigurationFileMap, String, String)

Ouvre le fichier de configuration Web spécifié en tant qu’un Configuration utilisant le mappage de fichiers spécifié, le chemin d’accès virtuel et le nom de site pour autoriser la lecture ou écriture de l’objet.

System_CAPS_pubmethodSystem_CAPS_staticOpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)

Ouvre le fichier de configuration d'application Web spécifié en tant qu'un Configuration utilisant le mappage de fichiers spécifié, le chemin d'accès virtuel, le nom du site et l'emplacement pour autoriser la lecture ou écriture de l'objet.

System_CAPS_pubmethodSystem_CAPS_staticOpenWebConfiguration(String)

Ouvre le fichier de configuration d’application Web en tant qu’un Configuration à l’aide du chemin d’accès virtuel spécifié à autoriser lire ou écrire des opérations de l’objet.

System_CAPS_pubmethodSystem_CAPS_staticOpenWebConfiguration(String, String)

Ouvre le fichier de configuration d’application Web en tant qu’un Configuration utilisant le nom de site et de chemin d’accès virtuel spécifié pour autoriser la lecture ou écriture de l’objet.

System_CAPS_pubmethodSystem_CAPS_staticOpenWebConfiguration(String, String, String)

Ouvre le fichier de configuration d’application Web en tant qu’un Configuration à l’aide du chemin d’accès virtuel spécifié, le nom du site et l’emplacement pour autoriser la lecture ou écriture de l’objet.

System_CAPS_pubmethodSystem_CAPS_staticOpenWebConfiguration(String, String, String, String)

Ouvre le fichier de configuration d’application Web en tant qu’un Configuration utilisant le chemin d’accès virtuel spécifié, un nom de site, un emplacement et un serveur pour autoriser la lecture ou écriture de l’objet.

System_CAPS_pubmethodSystem_CAPS_staticOpenWebConfiguration(String, String, String, String, IntPtr)

Ouvre le fichier de configuration d’application Web en tant qu’un Configuration à l’aide du chemin d’accès virtuel spécifié nom du site, emplacement, serveur et contexte de sécurité pour autoriser la lecture ou écriture de l’objet.

System_CAPS_pubmethodSystem_CAPS_staticOpenWebConfiguration(String, String, String, String, String, String)

Ouvre le fichier de configuration d’application Web en tant qu’un Configuration à l’aide du chemin d’accès virtuel spécifié nom du site, emplacement, serveur et contexte de sécurité pour autoriser la lecture ou écriture de l’objet.

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

À l’aide de WebConfigurationManager est la meilleure façon de travailler avec des fichiers de configuration associés aux applications Web. Pour les applications clientes, utilisez la ConfigurationManager classe.

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

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

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

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

    • Advanced configuration. Gestion de configuration plus avancée est fournie par les types SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformation, ConfigurationSectionGroup, 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, ConfigurationProperty, et ConfigurationSection à l’aide d’un modèle attribué ou par programmation. Reportez-vous à la ConfigurationSection classe pour obtenir un exemple montrant comment étendre un type de configuration standard par programme. Reportez-vous à la ConfigurationElement classe pour obtenir un exemple de la façon d’étendre un type de configuration standard à l’aide du modèle attribué.

Remarques à l’attention des implémenteurs :

La Configuration classe permet un accès par programme pour modifier les fichiers de configuration. Vous utilisez une des méthodes open fournies par WebConfigurationManager. Ces méthodes retournent un Configuration objet, qui à son tour fournit les méthodes et propriétés requises pour gérer les fichiers de configuration sous-jacents. Vous pouvez accéder à ces fichiers pour lire ou écrire comme suit :

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

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

  • Autorisations de lecture sur tous les fichiers de configuration.

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

System_CAPS_noteRemarque

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

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

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

  • Autorisations de lecture sur tous les fichiers de configuration.

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

Méthode GetSection.


// 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();
}

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: