Exemplarische Vorgehensweise: Laden von Ressourcen aus einer Satellitenassembly

Článek
09/03/2008

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise wird erläutert, wie mit Windows Presentation Foundation (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.

Hinweis:
Je nach den aktiven Einstellungen oder der verwendeten Version können die angezeigten Dialogfelder und Menübefehle von den in der Hilfe beschriebenen abweichen. Sie können die Einstellungen ändern, indem Sie im Menü Extras auf Einstellungen importieren und exportieren klicken. Weitere Informationen hierzu finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

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

Visual Studio 2008.

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 hierzu finden Sie unter Gewusst wie: Erstellen eines neuen WPF-Anwendungsprojekts.

Die Datei Window1.xaml wird in 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 Window1.xaml.cs oder Window1.xaml.vb im Code-Editor.

Fügen Sie den folgenden Code oben in Window1.xaml.cs oder window1.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

Sdílet prostřednictvím