My.Application.ChangeCulture-Methode

Článek
08/20/2008

Aktualisiert: November 2007

Ändert die vom aktuellen Thread für Zeichenfolgenbearbeitung und -formatierung verwendete Kultur.

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

Parameter

cultureName
String. Der Name der Kultur als Zeichenfolge. Eine Liste möglicher Namen finden Sie unter CultureInfo.

Ausnahmen

Die folgenden Bedingungen können einen Ausnahmefehler verursachen:

Das cultureName-Argument ist Nothing (ArgumentNullException).
Das cultureName-Argument ist kein gültiger Kulturname (ArgumentException).

Hinweise

Die My.Application.ChangeCulture-Methode ändert die CurrentCulture-Eigenschaft des aktuellen Threads. CurrentCulture bestimmt das Standardformat für Datumsangaben, Uhrzeit, Währung, Zahlen, Sortierreihenfolge von Text, Zeichenfolgenvergleiche sowie Groß- und Kleinschreibung für alle Berechnungen in diesem Thread.

Um die aktuelle Kultur abzurufen, können Sie die My.Application.Culture-Eigenschaft-Eigenschaft oder die CurrentCulture-Eigenschaft verwenden.

Die CurrentCulture-Einstellung unterscheidet sich von der Spracheinstellung. Sie enthält nur Daten, die sich auf die Standardeinstellungen für eine geografische Region beziehen. Daher kann die CurrentCulture-Eigenschaft nur auf eine bestimmte Kultur oder die InvariantCulture festgelegt werden.

Verwenden Sie die My.Application.ChangeUICulture-Methode, um die Kultur zu ändern, die der aktuelle Thread zum Abrufen von kulturspezifischen Ressourcen verwendet.

Sicherheitshinweis:
Die My.Application.ChangeCulture-Methode erfordert eine SecurityPermission mit festgelegtem ControlThread. Das Ändern von Threads erweist sich aufgrund des mit Threads verbundenen Sicherheitsstatus als gefährlich. Daher sollte vertrauenswürdigem Code diese Berechtigung nur erteilt werden, wenn dies erforderlich ist. In teilweise vertrauenswürdigem Code kann die Kultur eines Threads nicht geändert werden.

Die My.Application.ChangeCulture-Methode erfordert eine SecurityPermission mit festgelegtem ControlThread. Das Ändern von Threads erweist sich aufgrund des mit Threads verbundenen Sicherheitsstatus als gefährlich. Daher sollte vertrauenswürdigem Code diese Berechtigung nur erteilt werden, wenn dies erforderlich ist. In teilweise vertrauenswürdigem Code kann die Kultur eines Threads nicht geändert werden.

Beispiel

In diesem Beispiel wird veranschaulicht, wie durch das Ändern der Kultur die Zeichenfolgenentsprechung von Datumsangaben geändert wird.

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