Exemplarische Vorgehensweise: Laden von Ressourcen aus einer Satellitenassembly

Artikel
08/10/2011

In dieser exemplarischen Vorgehensweise wird erläutert, wie mit WPF Designer für Visual Studio eine Ressourcenzeichenfolge aus einer Satellitenassembly geladen wird. Dies vereinfacht die Lokalisierung für WPF-Anwendungen.

Im Verlauf dieser exemplarischen Vorgehensweise führen Sie folgende Aufgaben aus:

Erstellen des Projekts.
Aktivieren der Satellitenassembly.
Erstellen und Öffnen einer Ressourcenzeichenfolge.

Anschließend verfügen Sie über eine einfache Anwendung, die eine Zeichenfolge aus einer Satellitenassembly abruft.

Tipp

Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Arbeiten mit Einstellungen.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

Visual Studio 2010.

Erstellen des Projekts

Zunächst muss das Projekt für die Anwendung erstellt werden.

So erstellen Sie das Projekt

Erstellen Sie ein neues WPF-Anwendungsprojekt in Visual Basic oder Visual C# mit dem Namen ResourceTest. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines neuen WPF-Anwendungsprojekts.

Die Datei MainWindow.xaml wird im WPF-Designer geöffnet.
Ziehen Sie ein Button-Steuerelement aus der Toolbox auf die Entwurfsoberfläche.
Doppelklicken Sie auf die Schaltfläche, um einen Click-Ereignishandler für das Schaltflächen-Steuerelement zu erstellen.

Aktivieren der Satellitenassembly

Sie aktivieren die Satellitenassembly, indem Sie geringfügige Änderungen an der AssemblyInfo-Datei und den Projektdateien vornehmen.

So aktivieren Sie die Satellitenassembly

Öffnen Sie AssemblyInfo.cs bzw. AssemblyInfo.vb im Code-Editor. Um die Datei im Projektmappen-Explorer anzuzeigen, müssen Sie unter Umständen auf die Schaltfläche Alle Dateien anzeigen klicken.

Heben Sie die Auskommentierung der folgenden Zeile auf.

//[assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]

'<Assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)>

Speichern Sie die Projektmappe.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt ResourceTest, und klicken Sie auf Projekt entfernen.

Visual Studio entfernt das ResourceTest-Projekt aus dem Speicher.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das ResourceTest-Projekt, und wählen Sie ResourceTest.csproj bearbeiten oder ResourceTest.vbproj bearbeiten aus.

Die Projektdatei wird im XML-Editor geöffnet.
Fügen Sie die folgende XML auf derselben Ebene wie die anderen <PropertyGroup>-Elemente ein.
```
<PropertyGroup>
    <UICulture>en-US</UICulture>
</PropertyGroup>
```
Speichern und schließen Sie die Datei.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt ResourceTest, und klicken Sie auf Projekt erneut laden.
Ändern Sie im Projektmappen-Explorer den Namen der Standard-RESX-Datei von Resources.resx. in Resources.en-US.resx.
Löschen Sie im Eigenschaftenfenster den Wert für Benutzerdefiniertes Tool der Ressourcendatei.

Erstellen einer Ressourcenzeichenfolge in der Satellitenassembly

Jetzt erstellen Sie eine Zeichenfolge in der Ressourcendatei.

So erstellen Sie eine Ressourcenzeichenfolge in der Satellitenassembly

Doppelklicken Sie im Projektmappen-Explorer auf Resources.en-US.resx.

Resources.en-US.resx wird im Ressourcen-Designer geöffnet.
Ändern Sie den Namen der Standardzeichenfolge von String1 in helloWorldString.
Ändern Sie den Wert von helloWorldString in Hello World.
Speichern Sie die Datei, und schließen Sie den Ressourcen-Editor.

Zugreifen auf die Ressourcenzeichenfolge

Öffnen Sie mit der ResourceManager-Klasse die Zeichenfolge in der Satellitenassembly.

So greifen Sie auf die Ressourcenzeichenfolge zu

Öffnen Sie MainWindow.xaml.cs oder MainWindow.xaml.vb im Code-Editor.

Fügen Sie den folgenden Code oben in MainWindow.xaml.cs oder MainWindow.xaml.vb ein.

using System.Reflection;
using System.Resources;

Imports System.Reflection
Imports System.Resources

Fügen Sie den folgenden Code in den button1_Click-Ereignishandler ein.

ResourceManager rm = new ResourceManager(
    "ResourceTest.Properties.Resources", 
     Assembly.GetExecutingAssembly());
MessageBox.Show(rm.GetString("helloWorldString"));

Dim rm As New ResourceManager( _
    "ResourceTest.Resources", _
    Assembly.GetExecutingAssembly())
MessageBox.Show(rm.GetString("helloWorldString"))

Drücken Sie F5, um die Anwendung zu erstellen und auszuführen.
Klicken Sie auf die Schaltfläche, um den aus der Satellitenressource geladenen Zeichenfolgenwert anzuzeigen.
Öffnen Sie den Ordner Debug/en-US, um die Satellitenassembly mit dem Namen ResourceTest.resources.dll anzuzeigen.

Siehe auch

Referenz

ResourceManager

Weitere Ressourcen

Bereitstellung und Lokalisierung mit dem WPF-Designer

Codierung und Lokalisierung

Share via