Comment : récupérer des ressources localisées dans Visual Basic

L'objet My.Resources fournit les ressources d'application localisées (si disponible) en fonction des paramètres de culture de l'ordinateur sur lequel s'exécute l'application. Vous pouvez substituer les paramètres de culture de l'ordinateur en définissant la propriété UICulture.

Le runtime identifie une ressource localisée par la signature de sa culture, ou nom. Resources.resx, le fichier de ressources par défaut du projet, détermine les propriétés que l'objet My.Resources affiche. Pour fournir des ressources localisées, vous devez :

  • copier le fichier de ressources et le renommer en Resources.CultureSignature.resx ;

  • rechercher les chaînes et les fichiers référencés par le fichier de ressources ;

  • ajouter le fichier de ressources à votre projet.

L'objet My.Resources expose chaque ressource en tant que propriété en lecture seule. Le nom de la propriété est le même que le nom de la ressource, et le type de propriété est déterminé par la classification de la ressource. Pour plus d'informations, consultez Objet My.Resources (Visual Basic) et Ressources dans les applications.

Chaque culture a un nom unique, qui est une combinaison d'un nom de culture de deux lettres en minuscules associé à une langue, et si nécessaire, un nom de sous-culture en majuscules à deux lettres associé à un pays ou une région. Le nom de la sous-culture suit le nom de la culture, séparé par un tiret (-). Par exemple, ja-JP pour japonais au Japon, en-US pour anglais américain ou de-DE pour allemand en Allemagne (par opposition à de-AT pour allemand en Autriche). Pour plus d'informations sur les noms de cultures, consultez CultureInfo.

Exemple

Cet exemple récupère la version de culture française de la ressource de type chaîne de l'application nommée Message.

Pour modifier la culture que l'objet My.Resources utilise, cet exemple fait appel à la méthode ChangeUICulture.

Sub ShowLocalizedMessage()
    Dim culture As String = My.Application.UICulture.Name
    My.Application.ChangeUICulture("fr-FR")
    MsgBox(My.Resources.Message)
    My.Application.ChangeUICulture(culture)
End Sub

Pour que cet exemple fonctionne, une chaîne nommée Message doit figurer dans le fichier de ressources de l'application et cette dernière doit utiliser la version de culture française de ce fichier de ressources, Resources.fr-FR.resx. Pour plus d'informations, consultez Comment : ajouter ou supprimer des ressources.

Si l'application n'a pas la version de la culture française de ce fichier de ressources, l'objet My.Resource récupère la ressource à partir du fichier de ressources de la culture par défaut.

Voir aussi

Tâches

Comment : récupérer des ressources de type chaîne dans Visual Basic

Référence

Objet My.Resources (Visual Basic)

Autres ressources

Gestion des ressources de l'application