My.Application.ChangeUICulture, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Modifie la culture que le thread actuel utilise pour récupérer des ressources spécifiques à la culture.

' Usage
My.Application.ChangeUICulture(cultureName)
' Declaration
Public Sub ChangeUICulture( _
   ByVal cultureName As String _
)

Paramètres

cultureName
String. Nom de la culture sous forme de chaîne. Pour obtenir la liste des noms possibles, consultez CultureInfo.

Exceptions

Les conditions ci-dessous peuvent générer une exception :

L'argument cultureName a la valeur Nothing (ArgumentNullException).
L'argument cultureName n'est pas un nom de culture valide (ArgumentException).

Notes

La méthode My.Application.ChangeUICulture modifie la propriété CurrentUICulture du thread actuel. La propriété CurrentUICulture détermine la culture utilisée par le Gestionnaire de ressources et l'objet My.Resources. Elle utilise ces informations pour rechercher des ressources spécifiques à la culture au moment de l'exécution.

Pour récupérer la culture de l'interface utilisateur actuelle, vous pouvez utiliser la propriété My.Application.UICulture ou la propriété CurrentUICulture.

Utilisez la méthode My.Application.ChangeCulture pour modifier la culture que le thread actuel utilise pour la manipulation et la mise en forme des chaînes.

Exemple

Cet exemple utilise la méthode My.Application.ChangeUICulture pour définir la culture que l'objet My.Resources utilise pour récupérer des ressources.

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.

Configuration requise

Espace de noms :Microsoft.VisualBasic.ApplicationServices

Classe :WindowsFormsApplicationBase, ApplicationBase

Assembly : bibliothèque Runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Non
Service Windows	Oui
Site Web	Non