Aller au menu - Aller au contenu

Icône [Visual C#] Utiliser les paramètres d'application

Avatar
Par Avatar H@des
Mise à jour : 30/12/2010
Difficulté : Facile Facile Durée d'étude : 1 heure, 30 minutes Creative Commons BY-NC-ND
105 visites depuis 7 jours, classé 558/786
Salut à tous et bienvenue dans ce tutoriel !

Vous avez besoin de stocker des données sans utiliser les bases de données (SQL et LINQ) ?
Vous êtes débutant et vous connaissez les bases du langage C# ?

Dans ce cas, ce tutoriel est fait pour vous !
Retour en haut
Sommaire du tutoriel :
Icône du chapitre
Retour en haut

Les fichiers de configuration

Les paramètres d'application sont des données comprises dans des fichiers de configuration qui sont écrits en XML.

Attention, ne pas confondre fichiers de configuration et paramètres d'application !

Si vous ne savez pas ce qu'est le XML, voici un exemple de code :

Code : XML
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <configSections>
        <sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="Tutoriel.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
        </sectionGroup>
    </configSections>
    <userSettings>
        <Tutoriel.Properties.Settings>
            <setting name="Setting" serializeAs="String">
                <value>Ceci est un exemple d'utilisation de notre fichier XML pour une application C# !</value>
            </setting>
        </Tutoriel.Properties.Settings>
    </userSettings>
</configuration>

Pour de plus amples informations sur XML, vous pouvez lire le tutoriel de Tangui qui l'explique en détail.

Vous verrez plus tard, dans la troisième partie, comment utiliser ces fichiers par l'intermédiaire de C#. Je tiens à préciser que le .NET Framework permet d'accéder à ces fichiers très simplement à l'aide d'une seule méthode !

Le XML est utilisé de deux façons différentes :
  • avec l'aide de XPath ;
  • avec l'outil de Visual C#.

L'outil livré avec Visual C# est celui que nous utiliserons dans ce cours.
Retour en haut

Soyez prêt !

Nous allons maintenant commencer.

J'utiliserai Microsoft Visual Studio 2010 avec le .NET Framework 4.0 dans ce tutoriel. N'ayez crainte, que vous ayez une version express de Visual Studio 2010 ou 2008, ça ne changera rien. ;)

Bon alors, commençons !

Création du projet !


Lancez Microsoft Visual C# (pas trop loin ^^ ).

Créez un nouveau projet : Fichier → Nouveau projet → Application Windows Forms / Application WPF. Après, à vous de choisir si vous voulez créer un projet WinForms ou WPF. Ça ne changera rien.

Nommez votre projet : « Vive H@des », par exemple.

Petite précision : je ne supporterai pas si vous mettez autre chose que mon nom ! :pirate:

Maintenant, reste à créer le fichier *.config.

Le fichier *.config


Nous allons entamer la création et la construction du fichier *.config.

Pour cela, il vous faudra double-cliquer sur Properties ou Propriétés dans l'explorateur de solutions : vous devriez voir apparaître les options de l'application, mais pas encore les paramètres de configuration.

Attention à ne pas confondre !

Afin de voir ces paramètres, double-cliquez sur... Paramètres. ^^
Vous voyez donc apparaître ceci :

Image utilisateur
  • Le nom correspond au nom du paramètre que vous utiliserez dans votre partie code source. Bien évidemment, n'utilisez pas d'espaces ni de caractères spéciaux.
  • Le type sert à préciser de quel type sera la variable. Il existe aussi d'autres types, comme la taille.
  • La portée. Deux choix sont possibles. Je vous en parlerai après.
  • Et la valeur, qui sert, comme vous l'avez sûrement compris, à stocker la valeur que contiendra la variable. Vous pouvez très bien ne rien mettre, ce qui sera équivalent à un null.

Comme je l'ai dit, pour la portée du paramètre, il y a un choix à faire parmi :
  • Application. Cette portée est utilisable seulement en lecture seule. Vous ne pourrez la modifier que par Visual Studio ou par exemple le célèbre Bloc-notes de Windows, mais surtout pas par l'application ; ;)
  • Utilisateur. Contrairement à la portée Application, celle-ci est utilisable et modifiable à n'importe quel moment.


Vous l'avez sans doute remarqué, mais quand vous créez votre premier paramètre, un fichier *.config est créé dans votre solution. C'est lui qui contient toutes les données. Visual C# ne fait que le générer et l'interpréter !

Notez que quand vous utilisez la portée Utilisateur, les paramètres ne sont pas stockés dans le fichier *.config à la racine de votre application, mais dans un nouveau fichier [user].config où [user] désigne le nom de la session utilisateur. C'est comme ça que chaque utilisateur peut enregistrer ses valeurs préférées.

Mais il y a quelque chose de surligné en rouge sur l'image ! Qu'est-ce que c'est ?

Je reviendrai sur ce point tout à l'heure. ;)

Le T.P. de ce tutoriel est un navigateur web qui devra, au démarrage, lire ce paramètre qui est une URL et afficher la page web. Il y aura aussi un bouton afin de donner l'URL de la page web actuelle à notre paramètre.

Vous suivez ? ^^

Nous allons juste mettre une seule propriété :

Nom Type Portée Valeur
PageDeDemarrage String Utilisateur
1
 http://www.siteduzero.com/


1 → Nous allons mettre Utilisateur car notre programme va consister, comme je l'ai dit, à ouvrir une page web et en définir une. Donc on a besoin de modifier cette valeur : → public. Une fois que tout ceci sera bon et que vous aurez validé, vous retournerez sur votre formulaire Forms1.cs [Desgin] ou Window1.xaml.

Maintenant, double-cliquez sur « App.config » ; vous devriez avoir ce code :

Code : XML
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <configSections>
        <sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="Projet.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
        </sectionGroup>
    </configSections>
    <userSettings>
        <Projet.Properties.Settings>
            <setting name="PageDeDemarrage" serializeAs="String">
                <value>http://www.google.fr/</value>
            </setting>
        </Projet.Properties.Settings>
    </userSettings>
</configuration>


Nous n'allons pas étudier ces lignes de code en XML. Si vous avez lu le lien que je vous avais donné au début du tutoriel, vous comprendrez. ;)

Revenons à l'image de tout à l'heure ! Vous êtes peut-être impatient de savoir quelle est cette chose soulignée ! o_O

La chose soulignée est une fonction de Visual Studio qui permet de gérer les événements du fichier *.config. Ça y est, j'en ai trop dit. >_<

Eh oui ! Visual Studio permet de gérer des événements du fichier *.config. C'est un outil puissant que nous avons là !

Quand vous cliquez dessus, Visual Studio vous ouvre un fichier source.

Code : C#
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
namespace ParametreApplication.Properties {
    
    
    // Cette classe vous permet de gérer des événements spécifiques dans la classe de paramètres :
    //  l'événement SettingChanging est déclenché avant la modification d'une valeur de paramètre ;
    //  l'événement PropertyChanged est déclenché après la modification d'une valeur de paramètre ;
    //  l'événement SettingsLoaded est déclenché après le chargement des valeurs de paramètre ;
    //  l'événement SettingsSaving est déclenché avant l'enregistrement des valeurs de paramètre.
    internal sealed partial class Settings {
        
        public Settings() {
            // // Pour ajouter des gestionnaires d'événements afin d'enregistrer et de modifier les paramètres, supprimez les marques de commentaire des lignes ci-dessous :
            //
            // this.SettingChanging += this.SettingChangingEventHandler;
            //
            // this.SettingsSaving += this.SettingsSavingEventHandler;
            //
        }
        
        private void SettingChangingEventHandler(object sender, System.Configuration.SettingChangingEventArgs e) {
            // Ajouter du code pour gérer l'événement SettingChangingEvent ici.
        }
        
        private void SettingsSavingEventHandler(object sender, System.ComponentModel.CancelEventArgs e) {
            // Ajouter du code pour gérer l'événement SettingsSaving ici.
        }
    }
}


Tout est expliqué dans ce code source par l'intermédiaire des commentaires. Vous n'aurez pas besoin de moi. ;)

Personnalisons notre formulaire !


Maintenant, nous allons nous occuper de l'apparence du formulaire. Glissez un WebBrowser dans votre formulaire (je suppose que vous savez faire ça).

En WPF


Mettez le VerticalAlignment à Stretch ainsi que l'HorizontalAlignment.

En WinForm


Mettez-le tout simplement en Dock.Fill. Puis mettez un Button n'importe où dans votre formulaire qui contient le texte suivant : « Définir cette page comme page de démarrage. »

Et voilà, c'était tout pour cette sous-partie.
Retour en haut

Utiliser les paramètres d'application !

Bon... Assez discuté !

Je vais enfin vous donner la syntaxe pour les paramètres d'application. Il n'y en a que deux ; ce sont des propriétés, générées automatiquement par Visual Studio, ce qui veut dire que ces paramètres sont utilisés de la même manière que des Propriétés get{} set{} .

Non, vous ne rêvez pas ! Je vous avais prévenu que c'était d'une simplicité ! C'est votre jour de chance !

Je vais commencer par mettre la syntaxe permettant de lire une de ces propriétés. Et puis comme vous savez aussi en définir une, je vous laisserai deviner la syntaxe pour le faire.

Lire



Syntaxe


Code : Autre
1

[Type] [NomDuType] = Properties.Settings.Default.[NomDuParamètre];

Vous ne devez pas mettre les crochets ! C'est pour vous montrer ce qu'il y a à modifier.


Dans notre cas


Code : C#
1
2
string Url = Properties.Settings.Default.PageDeDemarrage;
webBrowser1.Navigate(Url);

Notez que vous pouvez utiliser directement le paramètre ! Rien de tel pour se simplifier la vie !

Code : C#
1
webBrowser1.Navigate(Properties.Settings.Default.PageDeDemarrage);


Écrire



Syntaxe


Code : Autre
1

Properties.Settings.Default.[NomDuParamètre] = [Valeur];

[Type] et [NomDuType] doivent être de même type. Les casts fonctionnent quand même, mais je ne vois pas l'intérêt puisque [NomDuType] peut s'agir de n'importe quel type de variable.

Si vous voulez réutiliser la même valeur pour le type lors d'une prochaine session, vous devez sauvegarder les changements (dans l'événement _Closing de votre application). Ça ne sert à rien de sauvegarder le fichier à chaque fois qu'il y a un changement, mettez-le uniquement à la sortie de votre application !

Code : C#
1
Properties.Settings.Default.Save();


Dans notre cas


Code : C#
1
2
Properties.Settings.Default.PageDeDemarrage = "http://www.siteduzero.com/";
Properties.Settings.Default.Save();


C'est bon ! Vous maîtrisez les fichiers de configuration ! Maintenant, place à la pratique !

Dans notre programme



Je vais vous demander de gérer l'événement : _Load pour votre fenêtre et l'événement : _Click pour votre bouton. Donc dans : _Load, je vais vous demander de charger une URL de type string dans votre composant : webBrowser1, sachant que pour charger une URL à partir de ce composant, la syntaxe est la suivante :

Code : C#
1
webBrowser1.Navigate([IciVousMettezL'UrlAChargerSansLesCrochets]);


Et dans l'événement _Click de notre bouton, je voudrais que la page actuelle sur le composant webBrowser1 soit définie dans le paramètre PageDeDemarrage. Pour obtenir l'URL de la page actuelle, vous devez utiliser la propriété Url du composant WebBrowser :

Code : C#
1
webBrowser1.Url();


Je veux aussi que vous sauvegardiez le paramètre pour une prochaine session !

Bon ! J'en ai trop dit ! Bonne chance !

Je vous laisse 5 minutes !

3...
2...
1...
:pirate: GO !!!

Voici la correction :

Secret (cliquez pour afficher)
Code : C#
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;

namespace ParametreApplication
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void Form1_Load()
        {
            webBrowser1.Navigate(Properties.Settings.Default.PageDeDemarrage);
        }

        private void button1_Click(object sender, EventArgs e)
        {
            Properties.Settings.Default.PageDeDemarrage = webBrowser1.Url.ToString();
        }

        private void Form1_FormClosing(object sender, FormClosingEventArgs e)
        {
            Properties.Settings.Default.Save();
        }
    }
}


Maintenant, nous pouvons exécuter notre programme et vous voyez le navigateur charger la page définie dans le fichier *.config, et quand on clique sur le bouton, il donne l'URL de la page actuelle à notre Type dans le fichier *.config pour qu'il puisse charger la page lors d'une prochaine session.
Retour en haut

Q.C.M.

Que sont les fichiers de configuration ?
Imaginons qu'on veuille mettre de l'argent sur votre compte en banque par l'intermédiaire des paramètres de l'application, qu'écririez-vous ?

Statistiques de réponses au QCM

Retour en haut
Ceci marque la fin du tutoriel !

Comme vous le voyez, ce système d'utilisation pour stocker vos données est très simple et est aujourd'hui utilisé dans la plupart des programmes.

Je tenais à remercier Thunderseb, Orwell et Coyote pour m'avoir aidé à rendre ce tutoriel publiable.
Et aussi aux zCorrecteurs zoubab et Fihld pour avoir corriger mon tutoriel très rapidement. ;)
Retour en haut

Partager

Retour en haut

Lire aussi

Icône
Lire et écrire des fichiers
Icône
Apprenez à programmer en C# sur .NET
Icône
Procédures et fonctions I
Icône
Apprenez à développer en C#
Retour en haut
4 commentaires pour "[Visual C#] Utiliser les paramètres d'application"
Note moyenne : 3.75 / 4 (4 votes)
Pseudo Commentaire
Hors ligne Mangepain # Posté le 30/12/2010 à 19:45:44
Le pain, ça fait du bien
Avatar
Flux RSS
close

Études : SUPINFO Midi-Pyrénées à Toulouse

 Et pourtant un "Vive Mangepain" serait bien placé :p
Apprenez à programmer avec C# et .net

Blog de 4 passionnés de .net sur lequel je publie : onefor4
 
Hors ligne Macros Le Noir # Posté le 30/12/2010 à 20:22:55
Fonscar
Avatar

Ville : Versoix
Pays : Suisse

 Image trop grande.
Mon tutoriel sur le cracking

Tutoriel Assembleur en cours de rédaction :) ! Plus d'infos ici et bêta test ici
Participe aussi à la relecture d'un tuto sur l'architecture matérielle des ordinateurs rédigé par mewtow. :) Plus d'infos ici et bêta test ici.
When I smoke my Weed, I feel so free, juste like a Ganja tree <3 .
 
Hors ligne H@des # Posté le 31/12/2010 à 08:50:43
Oui à OpenGL !
Avatar

Avis : Très bon
close

Citation : Mangepain
Et pourtant un "Vive Mangepain" serait bien placé :p

Tu crois ? ^^

Citation : Macros Le Noir
Image trop grande.

Réctifié !
Image utilisateur
Image utilisateur
Les raisons pour ne pas utiliser DirectX !
 
Hors ligne planete.game57 # Posté le 04/01/2011 à 21:52:26
Avatar
close

Études : IRIS

 Ton tutoriel est super intéressant !

Merci à toi H@des. ;)
xHTML/CSS |||||||||| 100% | PHP/MySQL |||||||||| 100% | Langage C |||||||||| 8.5%
Python |||||||||| 100% | JavaScript |||||||||| 5.5% | Photoshop |||||||||| 0.0%
Smarty |||||||||| 100%

Image utilisateurImage utilisateur
 

Voir tous les commentaires
Ce tutoriel a été corrigé par les zCorrecteurs.