Comment faire pour stocker et récupérer les informations personnalisées d'un fichier de configuration application à l'aide de Visual Basic .NET ou Visual Basic 2005

Traductions disponibles Traductions disponibles
Numéro d'article: 313405 - Voir les produits auxquels s'applique cet article
Pour une version de Microsoft Microsoft Visual C# .NET de cet article, voir 815786.
Agrandir tout | Réduire tout

Sommaire

Résumé

Cet article explique comment stocker des informations personnalisées dans un fichier de configuration (.config) que vous pouvez retrouver ultérieurement lors de l'exécution par son application associée. Ceci est un utile lorsque vous devez définir des données sont associées à une application.


Configuration requise

La liste suivante met en évidence le matériel recommandé, logiciel infrastructure réseau et service packs dont vous avez besoin :
  • Microsoft Windows 2000, Microsoft Windows XP ou Microsoft Windows Server 2003
  • Microsoft Visual Studio .NET (2002) ou les Microsoft Visual Studio .NET (2003) ou les Microsoft Visual Studio 2005
Cet article suppose que vous êtes familiarisé avec les sujets suivants :
  • (XML) Extensible Markup Language
  • Fichiers de configuration .NET

Créer application console lectures le contenu du fichier de configuration

Vous pouvez stocker les paramètres d'application dans le fichier de configuration qui est associée à l'application. Les fichiers de configuration sont enregistrés dans XML format. Le System.Configuration et les espaces de noms System.Collections.Specialized dans le Microsoft .NET Framework comprennent les classes nécessaires pour extraire des informations d'un fichier de configuration d'application .NET lors de l'exécution.

Pour créer une application de console qui lit le contenu d'un fichier de configuration associé au moment de l'exécution, procédez comme suit :
  1. Démarrez Visual Studio .NET ou Visual Studio 2005.
  2. Créez un nouveau projet d'application de console nommé ConConfig dans Visual Basic .NET ou Visual Basic 2005. Visual Basic .NET ou Visual Basic 2005 crée un module nommé Module1 par défaut.
  3. Cliquez avec le bouton droit sur le ConConfig Project dossier, pointez sur Ajouter , puis cliquez sur Ajouter un nouvel élément .

    note Dans Visual Studio 2005, cliquez le ConConfig avec le bouton droit Project dossier, pointez sur Ajouter , puis cliquez sur Nouvel élément .
  4. Dans la boîte de dialogue Ajouter un nouvel élément , sélectionnez le modèle Application Configuration File , cliquez sur Ouvrir et puis ajouter le fichier App.config au projet.

    note Le Visual Studio .NET ou IDE Visual Studio 2005 copie App.config dans le dossier dans lequel le fichier exécutable est compilé et renomme en <ApplicationName>. <Application Type>.config mettre en forme.
  5. Vous pouvez utiliser un fichier de configuration d'application pour collecter les paramètres d'application personnalisée que vous enregistrez au format clé/valeur. Vous pouvez inclure <add>éléments dans le <appsettings>section d'un fichier de configuration associé. Chaque paire clé/valeur possède un <add>élément. Un <add>élément a le format suivant :
    <add key="theKey" value="theValue" />
    						
    ajouter un <appsettings>section avec <add>éléments dans le fichier de configuration entre les balises <configuration> et </configuration>. Par exemple, le fichier de configuration suivant inclut un<appsettings>section qui spécifie trois cléent/valeur paires :
    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
    	<appSettings>
    		<add key="Key0" value="0" />
    		<add key="Key1" value="1" />
    		<add key="Key2" value="2" />
    	</appSettings>
    </configuration>
    					
  6. Dans l'Explorateur de solutions, double-cliquez sur Module1.vb pour afficher la fenêtre de code Module1. Ajoutez les instructions suivantes à votre module de code :

    note Ces instructions doivent s'afficher avant les autres états dans le fichier.
    Imports System.Configuration
    Imports System.Collections.Specialized
    					
  7. Dans la procédure Sub Main , dimensionnez une variable chaîne pour conserver la valeur d'une clé de fichier de configuration dans le <appsettings>section du fichier de configuration :
    Dim sAttr As String
    					
  8. Pour extraire une valeur pour une clé spécifiée la <appsettings>section du fichier de configuration, utilisez la méthode AppSettings de la classe ConfigurationSettings . La classe ConfigurationSettings est dans l'espace de noms System.Configuration . Lorsque la méthode AppSettings reçoit un paramètre d'entrée chaîne qui contient une clé, l'application extrait la valeur qui est associée à la clé.

    Le code suivant extrait la valeur de l'attribut Key0 du fichier de configuration associé. Le code place ensuite cette valeur dans la variable de chaîne sAttr . Si une clé n'existe pas pour que cette valeur, Nothing est stocké dans sAttr .
    sAttr = ConfigurationSettings. AppSettings("Key0")
    					
    AppSettings("Key0")
  9. Pour afficher la valeur de l'application copie dans la fenêtre de console, utilisez Console.WriteLine :
    Console.WriteLine("The value of Key0: " & sAttr)
    					
  10. Vous pouvez utiliser une référence à la propriété AppSettings pour extraire tous les paires clé/valeur dans le <appsettings>section. Si vous ne spécifiez pas les paramètres lorsque vous utilisez la propriété AppSettings , l'application renvoie tous les associé paires clé/valeur. Ces paires sont stockés dans un type de collection NameValueCollection , qui contient des entrées clé/valeur pour chaque clé qui récupère l'application. La classe de collection NameValueCollection est dans l'espace de noms System.Collections.Specialized .
    Dim sAll As NameValueCollection
    sAll = ConfigurationSettings.AppSettings()
    					
  11. La propriété AllKeys de NameValueCollection fait référence à un tableau comportant une entrée pour chaque clé qui l'application extrait une chaîne. Utilisez une construction For Next pour itérer dans le tableau AllKeys pour accéder à chaque clé qui récupère l'application. Chaque entrée de clé de AllKeys est une chaîne donnée de type.
    Dim s As String
    For Each s In sAll.AllKeys
    					
  12. Dans la structure For Each , utiliser Console.WriteLine pour afficher la clé et sa valeur associée dans la console de fenêtre. La clé actuelle qui traite de l'application est en « s ». Utilisez cette sous la forme d'un index dans sAll NameValueCollection pour obtenir la valeur associée.

    Par exemple, si l'application traite la clé Key0 , sAll("Key0") extrait la valeur associée. L'instruction Console.readline interrompt la console. Vous pouvez appuyer sur ENTRÉE pour terminer l'application.
        Console.WriteLine("Key: " & s & " Value: " & sAll(s))
    Next
    Console.Readline
    					

Vérifiez qu'il fonctionne

Appuyez sur la touche F5 pour exécuter le code. La fenêtre de console doit afficher les paires clé/valeur de la <appsettings>section du fichier configuration associé comme suit :
The value of Key0: 0
Key: Key0 Value:0
Key: Key1 Value:1
Key: Key2 Value:2
					

Terminer la liste de code

Imports System.Configuration
Imports System.Collections.Specialized

Module Module1

    Sub Main()
        Dim sAttr As String

        sAttr = ConfigurationSettings.AppSettings("Key0")
        Console.WriteLine("The value of Key0: " & sAttr)
        
        Dim sAll As NameValueCollection
        sAll = ConfigurationSettings.AppSettings()

        Dim s As String
        For Each s In sAll.AllKeys
            Console.WriteLine("Key: " & s & " Value: " & sAll(s))
        Next
		  Console.ReadLine()
    End Sub

End Module
				

Exécuter le fichier de configuration de liste (ConConfig.exe.config)

<configuration>
	<appSettings>
		<add key="Key0" value="0"/>
		<add key="Key1" value="1"/>
		<add key="Key2" value="2"/>
	</appSettings>
</configuration>
				

Résolution des problèmes

  • Le fichier de configuration est enregistré au format XML. Assurez-vous de suivre toutes les règles de syntaxe XML. N'oubliez pas que XML est sensible à la casse. Si le code XML n'est pas bien formé, ou si un élément est mal orthographié, vous recevez une exception System.Configuration.Configuration.

    Par exemple, si vous ajoutez l'attribut clé d'un <add>élément avec une majuscule « K » au lieu d'une MINUSCULE k, ou si le <appsettings>section s'affiche en tant que <appsettings>(par un majuscule « A » au lieu d'une MINUSCULE « a »), vous recevez un message d'erreur.
  • Le fichier de configuration doit être inclu dans le projet.
  • Vous devez utiliser la syntaxe suivante pour le nom de fichier de configuration lorsque le fichier est créé en dehors de l'environnement Visual Studio et il doit résider dans le même dossier que son application associée :
    ApplicationName.ApplicationType .config
    ApplicationName est le nom de l'application, ApplicationType est le type d'application (par exemple, exe) et .config représente le suffixe requis.

Références

Pour plus d'informations, reportez-vous aux sites adresses de Web MSDN suivantes :
ConfigurationSettings.AppSettings, propriété
http://msdn2.microsoft.com/en-us/library/system.configuration.configurationsettings.appsettings(vs.71).aspx
Espace de noms System.Configuration
http://msdn2.microsoft.com/en-us/library/system.configuration(vs.71).aspx

Propriétés

Numéro d'article: 313405 - Dernière mise à jour: mercredi 6 décembre 2006 - Version: 5.5
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft Visual Basic 2005
  • Microsoft Visual Basic .NET 2003 Initiation
  • Microsoft Visual Basic .NET 2002 Initiation
Mots-clés : 
kbmt kbvs2005swept kbvs2005applies kbconfig kbhowtomaster KB313405 KbMtfr
Traduction automatique
IMPORTANT : Cet article est issu du système de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d?articles obtenus par traduction automatique sont en effet mis à votre disposition en complément des articles traduits en langue française par des traducteurs professionnels. Cela vous permet d?avoir accès, dans votre propre langue, à l?ensemble des articles de la base de connaissances rédigés originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne étrangère s?exprimant dans votre langue !). Néanmoins, mis à part ces imperfections, ces articles devraient suffire à vous orienter et à vous aider à résoudre votre problème. Microsoft s?efforce aussi continuellement de faire évoluer son système de traduction automatique.
La version anglaise de cet article est la suivante: 313405
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com