Gewusst wie: Abrufen von lokalisierten Ressourcen in Visual Basic

Aktualisiert: November 2007

Das My.Resources-Objekt stellt lokalisierte Anwendungsressourcen (sofern verfügbar) auf Grundlage der Kultureinstellungen des Computers bereit, auf dem die Anwendung ausgeführt wird. Sie können die Kultureinstellungen des Computers überschreiben, indem Sie die My.Application.UICulture-Eigenschaft festlegen.

Die Common Language Runtime bestimmt eine lokalisierte Ressource anhand der Kultursignatur oder des Namens. Die Standardressourcendatei des Projekts, Resources.resx, bestimmt die Eigenschaften, die das My.Resources-Objekt anzeigt. Für die Bereitstellung lokalisierter Ressourcen ist Folgendes erforderlich:

  • Kopieren Sie die Ressourcendatei, und benennen Sie die Kopie in Resources.CultureSignature.resx um.

  • Lokalisieren Sie die Zeichenfolgen und alle Dateien, auf die die Ressourcendatei verweist.

  • Fügen Sie die lokalisierte Ressourcendatei dem Projekt hinzu.

Das My.Resources-Objekt macht jede Ressource als schreibgeschützte Eigenschaft verfügbar. Der Eigenschaftenname entspricht dem Ressourcennamen, und der Eigenschaftentyp wird von der Ressourcenklassifikation bestimmt. Weitere Informationen finden Sie unter My.Resources-Objekt und unter Ressourcen in Anwendungen.

Jede Kultur verfügt über einen eindeutigen Namen. Dieser besteht aus einem zweistelligen Kulturnamen in Kleinbuchstaben, der mit einer Sprache verknüpft ist, sowie gegebenenfalls aus einem zweistelligen Teilkulturnamen in Großbuchstaben, der mit einem Land oder einer Region verknüpft ist. Der Teilkulturname steht hinter dem Kulturnamen, getrennt durch einen Bindestrich (-). Beispielsweise steht ja-JP für Japanisch in Japan, en-US für amerikanisches Englisch oder de-DE für Deutsch in Deutschland (im Gegensatz zu z. B. de-AT für Deutsch in Österreich). Weitere Informationen zu Kulturnamen finden Sie unter CultureInfo.

Beispiel

In diesem Beispiel wird die Version für die Kultur Französisch der Zeichenfolgenressource mit dem Namen Message abgerufen.

In diesem Beispiel wird die My.Application.ChangeUICulture-Methode verwendet, um die vom My.Resources-Objekt verwendete Kultur zu ändern.

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 die Version der Ressourcendatei mit der Kultur Französisch verfügen (Resources.fr-FR.resx). Weitere Informationen hierzu finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Ressourcen.

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

Siehe auch

Aufgaben

Gewusst wie: Abrufen von Zeichenfolgenressourcen in Visual Basic

Referenz

My.Resources-Objekt

Weitere Ressourcen

Verwalten von Anwendungsressourcen