My.Application.ChangeUICulture-Methode

Artikel
08/20/2008

Aktualisiert: November 2007

Ändert die Kultur, die der aktuelle Thread zum Abrufen von kulturspezifischen Ressourcen verwendet.

' Usage
My.Application.ChangeUICulture(cultureName)
' Declaration
Public Sub ChangeUICulture( _
   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 eine Ausnahme verursachen:

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

Hinweise

Die My.Application.ChangeUICulture-Methode ändert die CurrentUICulture-Eigenschaft des aktuellen Threads. Die CurrentUICulture-Eigenschaft bestimmt die vom Ressourcen-Manager und vom My.Resources-Objekt verwendete Kultur. Diese Informationen werden von der Eigenschaft zum Abfragen kulturspezifischer Ressourcen zur Laufzeit verwendet.

Um die aktuelle Kultur der Benutzeroberfläche abzurufen, können Sie die My.Application.UICulture-Eigenschaft-Eigenschaft oder die CurrentUICulture-Eigenschaft verwenden.

Mit der My.Application.ChangeCulture-Methode ändern Sie die Kultur, die der aktuelle Thread für die Zeichenfolgenbearbeitung und Zeichenfolgenformatierung verwendet.

Beispiel

In diesem Beispiel wird die My.Application.ChangeUICulture-Methode verwendet, um die Kultur festzulegen, die das My.Resources-Objekt zum Abrufen von Ressourcen verwendet.

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

Damit dieses Beispiel ausgeführt werden kann, muss die Ressourcendatei der Anwendung die Zeichenfolge Message enthalten, und die Anwendung muss über Resources.fr-FR.resx verfügen, die Version der Ressourcendatei mit der Kultur Französisch. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Ressourcen.

Wenn die Anwendung nicht über die Version der Ressourcendatei mit der Kultur Französisch verfügt, ruft das My.Resource-Objekt die Ressource aus der Ressourcendatei für die Standardkultur ab.