My.Application.ChangeCulture, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Modifie la culture utilisée par le thread actuel pour la manipulation et la mise en forme de chaînes.

' Usage
My.Application.ChangeCulture(cultureName)
' Declaration
Public Sub ChangeCulture( _
   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.ChangeCulture modifie la propriété CurrentCulture du thread actuel. CurrentCulture détermine les formats par défaut pour les dates, les heures, la monnaie, les chiffres, l'ordre de tri du texte, les comparaisons de chaînes et la casse pour tous les calculs sur ce thread.

Pour récupérer la culture actuelle, vous pouvez utiliser la propriété My.Application.Culture ou CurrentCulture.

Le paramètre CurrentCulture est différent d'un paramètre de langue. Elle contient uniquement des données liées aux paramètres standard en vigueur dans une région géographique. Par conséquent, seules une culture spécifique ou InvariantCulture peuvent être affectées à la propriété CurrentCulture.

Utilisez la méthode My.Application.ChangeUICulture pour modifier la culture utilisée par le thread actuel pour récupérer des ressources propres à la culture.

Note de sécurité :
La méthode My.Application.ChangeCulture requiert SecurityPermission avec le jeu ControlThread. L'état de sécurité associé aux threads rend la manipulation de threads dangereuse. Par conséquent, cette autorisation ne doit être accordée qu'au code fiable et uniquement en cas de nécessité. Vous ne pouvez pas changer la culture d'un thread dans du code de niveau de confiance partiel.

Exemple

Cet exemple montre comment la modification de la culture change la représentation sous forme de chaîne des dates.

Private Sub TestChangeCulture()
    ' Store the current culture.
    Dim currentculture As String = My.Application.Culture.Name
    MsgBox("Current culture is " & currentculture)

    Dim jan1 As New Date(2005, 1, 1, 15, 15, 15)

    My.Application.ChangeCulture("en-US")
    MsgBox("Date represented in en-US culture: " & jan1)
    ' 1/1/2005 3:15:15 PM

    My.Application.ChangeCulture("")
    MsgBox("Date represented in invariant culture" & jan1)
    ' 01/01/2005 15:15:15

    ' Restore the culture.
    My.Application.ChangeCulture(currentculture)
End Sub

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