Localisation de vos applications .NET avec Visual Studio

La première chose que vous devez faire, dans Visual Studio, pour pouvoir rendre votre application multilingue, c'est d'indiquer que justement, vous voulez une application localisable ;)
Pour cela, sur les propriétés de votre Form, repérez la propriété « Localizable » et positionnez-la à « True » (Vrai). Vous devez donc avoir ceci :

Ensuite, vous devez choisir les langues dans lesquelles votre application sera disponible. Une fois encore, Visual Studio vous facilite le travail. En effet, toujours dans les propriétés de votre Form, repérez la propriété « Language » et, au moyen de la comboBox, choisissez la liste des langues que vous souhaitez (par exemple Anglais et Français) :

À ce moment-là, Visual Studio va lier à votre formulaire trois fichiers de ressources :

• un fichier Form1.resx ;
• un fichier Form1.en.resx ;
• un fichier Form1.fr.resx.

Vous avez donc un fichier de ressources par langue choisie, plus un fichier de ressources principal. Vous pouvez visualiser ces fichiers en cliquant, dans l'explorateur de solutions, sur le petit plus à côté du nom de votre Form :

Si vous double-cliquez sur les fichiers ressources correspondants aux langues choisies (donc Form1.en.resx et Form1.fr.resx), Visual Studio vous affiche à l'écran, dans une sorte d'éditeur graphique, le contenu du fichier de ressources choisi, fichier qui n'est rien d'autre qu'un simple fichier XML. Comme vous pouvez le voir, le fichier comporte un champ « name » et un champ « value » : nous pouvons donc largement supposer que name sera pour le nom et value sera la valeur correspondante à ce nom.

Une fois l'ensemble des fichiers de langue créé, voyons maintenant comment les utiliser dans notre application.

Une fois les fichiers de langue créés, vous avez plusieurs choses à faire avant de pouvoir utiliser votre application :

• définition d'un ResourceManager : c'est lui qui ira chercher, dans vos fichiers de langue, la valeur correspondante au texte que vous voulez afficher ;
• définition de la liste des CultureInfo (langues) que vous souhaitez utiliser ;
• définition de la culture (langue) par défaut de votre application, au moyen de CurrentUICulture.

III-B-1. Définition du ResourceManager▲

private System.Resources.ResourceManager RM = null;

...

// LeResourceManager prend en paramètre : nom_du_namespace.nom_de_la_ressource_principale
RM = new System.Resources.ResourceManager("Localisation.Form1", System.Reflection.Assembly.GetExecutingAssembly());

III-B-2. Définition des CultureInfo▲

using System.Globalization;
...

private CultureInfo EnglishCulture = new CultureInfo("en-US");
private CultureInfo FrenchCulture = new CultureInfo("fr-FR");

III-B-3. Définition de la culture par défaut▲

// Définition de la culture par défaut
System.Threading.Thread.CurrentThread.CurrentUICulture = FrenchCulture;

public Form1()
{
    //
    // Requis pour la prise en charge du Concepteur Windows Forms
    //
    
    // Définition de la culture par défaut
    System.Threading.Thread.CurrentThread.CurrentUICulture = FrenchCulture;

    InitializeComponent();

    //
    // TODO : ajoutez le code du constructeur après l'appel à InitializeComponent
    //
}

Maintenant que tous les prérequis sont remplis, vous pouvez continuer le développement de votre application : il vous faut accéder aux ressources contenues dans les fichiers de ressources. Pour cela, l'objet ResourceManager possède la méthode  GetString, qui vous permet de récupérer la valeur de la ressource spécifiée pour la culture courante. Plus simplement, cela vous permet de récupérer la valeur de la ressource passée en paramètre pour l'affecter à la propriété Text du contrôle de votre Form.
Voyons ce que cela veut dire par le code :

using System.Globalization;
...

private void Form1_Load(object sender, System.EventArgs e)
{
    // LeResourceManager prend en paramètre : nom_du_namespace.nom_de_la_ressource_principale
    RM = new System.Resources.ResourceManager("Localisation.Form1", typeof(Form1).Assembly);

    // Affecte la valeur de la ressource MainTitle à la propriété Text de la fenêtre principale
    this.Text = RM.GetString("MainTitle");
};

Avec les explications que je vous ai fournies précédemment, vous devriez pouvoir comprendre ce bout de code facilement :) On affecte la valeur de la ressource MainTitle à la propriété Text de la fenêtre principale.
Mais, pour que tout cela fonctionne parfaitement, il faut justement définir la valeur de la ressource MainTitle, et cela dans tous vos fichiers de ressources. Pour cela, ouvrez les fichiers de ressources que Visuail Studio a créés pour vous au début (Form1.en.resx et Form1.fr.resx) puis :

1. Dans la colonne « name », indiquez le nom de la ressource à utiliser (dans notre cas, il s'agit de MainTitle) ;
2. Dans la colonne « value », indiquez la valeur de cette ressource (par exemple « Bonjour le monde »).

N'oubliez pas : vous devez effectuer ces deux (simples) opérations pour tous les fichiers de ressources que vous avez, tout en gardant à l'esprit que vous devrez traduire, dans la langue désirée, la valeur des ressources que vous inscrivez.
Voici par exemple, le résultat pour notre application de test :

Fichier de ressource français :

Fichier de ressource anglais :

Il ne vous reste plus qu'à compiler puis exécuter votre application pour observer le résultat :

Pour être sûr que la localisation fonctionne bien et que l'application peut aussi s'exécuter en anglais, il nous suffit de remplacer cette ligne :

System.Threading.Thread.CurrentThread.CurrentUICulture = FrenchCulture;

par cette ligne :

System.Threading.Thread.CurrentThread.CurrentUICulture = EnglishCulture;

Puis de relancer l'application et d'observer que le titre de la fenêtre principale a bien changé :

Voilà, vous venez de réaliser une application multilangue. :) Mais il serait peut-être intéressant de pouvoir changer la langue en cours d'application, comme le font la plupart de IHM (Interface Homme-Machine). C'est ce que nous allons voir tout de suite.

Pour pouvoir changer de langue au cours de votre application, vous devez juste changer la culture en cours au moyen de System.Threading.Thread.CurrentThread.CurrentUICulture (qui nous a permis, je vous le rappelle, de définir la culture par défaut de votre application).
Voici le code de notre application, dans le cas où nous avons deux boutons radio, un pour chaque langue (notez que cela fonctionne également avec des CheckBox, des MenusItems, etc.) :

private void radioButton2_CheckedChanged(object sender, System.EventArgs e)
{
    if ( radioButton1.Checked )
    {
        System.Threading.Thread.CurrentThread.CurrentUICulture = FrenchCulture;
    }
    else
    {
        System.Threading.Thread.CurrentThread.CurrentUICulture = EnglishCulture;
    }
    
    this.Text = RM.GetString("MainTitle");
}

Ce code, bien que fonctionnel, ne s'avère pas forcément très pratique : en effet, dans notre exemple, nous n'affichons qu'une seule ressource. Mais vos applications comportent bien plus d'un seul contrôle. Par conséquent, vous serez amené à écrire des parties de code en double, voire plus : celles qui se chargent de l'affichage. Pour résoudre ce problème, je vous suggère de créer une méthode AfficherTexte, dans laquelle vous mettrez votre code. Ensuite, il ne vous restera plus qu'à appeler cette méthode à chaque fois que vous en avez besoin. Cela vous fera gagner beaucoup de temps pour vos développements.
Voici une mise en application, sur notre application de test, de cette technique :

/// <summary>
/// Méthode chargée de l'affichage du texte des contrôles à partir des ressources des fichiers de langue.
/// </summary>

private void AfficherTexte()
{
    this.Text = RM.GetString("MainTitle");
}

Et voici maintenant l'appel à cette méthode :

private void radioButton2_CheckedChanged(object sender, System.EventArgs e)
{
    if ( radioButton1.Checked )
    {
        System.Threading.Thread.CurrentThread.CurrentUICulture = FrenchCulture;
    }
    else
    {
        System.Threading.Thread.CurrentThread.CurrentUICulture = EnglishCulture;
    }
            
    //this.Text = RM.GetString("MainTitle");
    AfficherTexte();
}

En compilant et exécutant notre application, nous nous apercevons bien, lors du changement de bouton, que le titre de la fenêtre principale change lui aussi de manière automatique:

Application en français :

Application en anglais :