Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

WebConfigurationManager, classe

Fournit l'accès aux fichiers de configuration tels qu'ils s'appliquent aux applications Web.

System.Object
  System.Web.Configuration.WebConfigurationManager

Espace de noms :  System.Web.Configuration
Assembly :  System.Web (dans System.Web.dll)
public static class WebConfigurationManager

Le type WebConfigurationManager expose les membres suivants.

  NomDescription
Propriété publiqueMembre statiqueAppSettingsObtient les paramètres d'application du site Web.
Propriété publiqueMembre statiqueConnectionStringsObtient les chaînes de connexion du site Web.
Début
  NomDescription
Méthode publiqueMembre statiqueGetSection(String)Récupère la section de configuration spécifiée à partir du fichier de configuration de l'application Web en cours.
Méthode publiqueMembre statiqueGetSection(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é.
Méthode publiqueMembre statiqueGetWebApplicationSectionRécupère la section de configuration spécifiée à partir du fichier de configuration de l'application Web en cours.
Méthode publiqueMembre statiqueOpenMachineConfiguration()Ouvre le fichier de configuration de l'ordinateur sur l'ordinateur actuel en tant qu'objet Configuration afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenMachineConfiguration(String)Ouvre le fichier de configuration de l'ordinateur sur l'ordinateur actuel en tant qu'objet Configuration afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenMachineConfiguration(String, String)Ouvre le fichier de configuration de l'ordinateur spécifié sur le serveur déterminé en tant qu'objet Configuration afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenMachineConfiguration(String, String, IntPtr)Ouvre le fichier de configuration de l'ordinateur spécifié sur le serveur déterminé en tant qu'objet Configuration, à l'aide du contexte de sécurité spécifié afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenMachineConfiguration(String, String, String, String)Ouvre le fichier de configuration de l'ordinateur spécifié sur le serveur déterminé en tant qu'objet Configuration, à l'aide du contexte de sécurité spécifié afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenMappedMachineConfiguration(ConfigurationFileMap)Ouvre le fichier de configuration de l'ordinateur en tant qu'objet Configuration, à l'aide du mappage de fichiers spécifié afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenMappedMachineConfiguration(ConfigurationFileMap, String)Ouvre le fichier de configuration de l'ordinateur en tant qu'objet Configuration, à l'aide de l'emplacement et du mappage de fichiers spécifiés, afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenMappedWebConfiguration(WebConfigurationFileMap, String)Ouvre le fichier de configuration de l'application Web spécifiée en tant qu'objet Configuration, à l'aide du mappage de fichiers et du chemin d'accès virtuel spécifiés, afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenMappedWebConfiguration(WebConfigurationFileMap, String, String)Ouvre le fichier de configuration de l'application Web spécifiée en tant qu'objet Configuration, à l'aide du mappage de fichiers, du chemin d'accès virtuel et du nom du site spécifiés, afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)Ouvre le fichier de configuration de l'application Web spécifiée en tant qu'objet Configuration, à l'aide du mappage de fichiers, du chemin d'accès virtuel, du nom du site et de l'emplacement spécifiés, afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenWebConfiguration(String)Ouvre le fichier de configuration de l'application Web en tant qu'objet Configuration, à l'aide du chemin d'accès virtuel spécifié, afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenWebConfiguration(String, String)Ouvre le fichier de configuration de l'application Web en tant qu'objet Configuration, à l'aide du chemin d'accès virtuel et du nom du site spécifiés, afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenWebConfiguration(String, String, String)Ouvre le fichier de configuration de l'application Web en tant qu'objet Configuration, à l'aide du chemin d'accès virtuel, du nom du site et de l'emplacement spécifiés, afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenWebConfiguration(String, String, String, String)Ouvre le fichier de configuration de l'application Web en tant qu'objet Configuration, à l'aide du chemin d'accès virtuel, du nom du site, de l'emplacement et du serveur spécifiés, afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenWebConfiguration(String, String, String, String, IntPtr)Ouvre le fichier de configuration de l'application Web en tant qu'objet Configuration, à l'aide du chemin d'accès virtuel, du nom du site, de l'emplacement, du serveur et du contexte de sécurité spécifiés, afin d'autoriser les opérations de lecture ou d'écriture.
Méthode publiqueMembre statiqueOpenWebConfiguration(String, String, String, String, String, String)Ouvre le fichier de configuration de l'application Web en tant qu'objet Configuration, à l'aide du chemin d'accès virtuel, du nom du site, de l'emplacement, du serveur et du contexte de sécurité spécifiés, afin d'autoriser les opérations de lecture ou d'écriture.
Début

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

Le meilleur moyen de travailler avec les fichiers de configuration en rapport avec les applications Web consiste à utiliser WebConfigurationManager. Pour les applications clientes, utilisez la classe ConfigurationManager.

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

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

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

    • Accessing configuration files . Votre application peut lire et écrire des paramètres de configuration à tout niveau, pour elle-même ou pour d'autres applications ou ordinateurs, localement ou à distance. Vous utilisez l'une des méthodes open fournies par WebConfigurationManager. Ces méthodes retournent un objet Configuration qui fournit, à son tour, les méthodes et propriétés requises pour gérer les fichiers de configuration sous-jacents. Ces méthodes exécutent 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 . La gestion d'une 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 classe ConfigurationSection pour obtenir un exemple d'extension d'un type de configuration standard par programme. Reportez-vous à la classe ConfigurationElement pour obtenir un exemple d'extension d'un type de configuration standard à l'aide du modèle par attributs.

Remarques à l'attention des implémenteurs

La classe Configuration autorise l'accès par programme pour modifier les fichiers de configuration. Vous utilisez l'une des méthodes ouvertes fournies par WebConfigurationManager. Ces méthodes retournent un objet Configuration 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 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 en lecture sur le fichier de configuration au niveau de la hiérarchie de configuration en cours.

  • Autorisations en lecture sur tous les fichiers de configuration parents.

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

RemarqueRemarque

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

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

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

  • Autorisations en lecture sur tous les fichiers de configuration.

TopicLocation
Comment : accéder par programme aux paramètres de configuration ASP.NETConfiguration d'applications Web ASP.NET
Comment : verrouiller des paramètres de configuration ASP.NETConfiguration d'applications Web ASP.NET
Comment : afficher des paramètres de configuration locaux et hérités par programmeConfiguration d'applications Web ASP.NET
Comment : accéder par programme aux paramètres de configuration ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : verrouiller des paramètres de configuration ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : afficher des paramètres de configuration locaux et hérités par programmeGénération d'applications Web ASP.NET dans Visual Studio

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

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

Pris en charge dans : 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tout membre static (Shared en Visual Basic) public de ce type est thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft. Tous droits réservés.