Partager via


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

Mise à jour : novembre 2007

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é My.Application.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 et attribuer au fichier de ressources le nouveau nom 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 My.Resources, objet 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 utilisée par l'objet My.Resources, cet exemple utilise la méthode My.Application.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, votre application doit avoir une chaîne nommée Message dans le fichier de ressources de l'application et cette dernière doit avoir la version de la 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

My.Resources, objet

Autres ressources

Gestion des ressources de l'application