Freigeben über

Windows Forms Resource Editor-Tool (Winres.exe)

  • Artikel

Der Ressourcen-Editor für Windows Forms, Winres.exe, ist ein visuelles Layouttool, das Lokalisierungsexperten beim Lokalisieren von Ressourcen der Windows Forms-Benutzeroberfläche unterstützt, die von Formularen verwendet werden. Die als Eingabe für Winres.exe verwendeten RESX- oder RESOURCES-Dateien können unter Verwendung einer visuellen Entwicklungsumgebung, wie Microsoft Visual Studio, erstellt werden. Information zum Bereitstellen von Ressourcen in .NET Framework-Anwendungen finden Sie unter Ressourcen in Anwendungen.

winres resourceFile 
winres /?

Hinweise

Argument Beschreibung

resourceFile

Die zu lokalisierende Ressourcendatei. Diese Datei muss ein als RESX- oder RESOURCES-Datei durch den Visual Studio-Designer generiertes Windows Forms-Formular sein. Winres.exe kann generische RESX- bzw. RESOURCES-Dateien nicht öffnen.
Option Beschreibung

/?

Zeigt die Befehlssyntax und die Optionen für das Tool an.

Der Zustand von Elementen der Benutzeroberfläche in einem Formular in einem Windows Forms-Projekt wird i. d. R. in Ressourcendateien gespeichert, bei denen es sich entweder um XML-basierte Dateien mit der Erweiterung .resx oder den entsprechenden kompilierten binären Versionen mit der Erweiterung .resources handelt. Mit Winres.exe ist die begrenzte Bearbeitung beider Dateitypen außerhalb der Visual Studio-Entwurfsumgebung möglich. Insbesondere können die folgenden Bearbeitungsvorgänge durchgeführt werden:

  • Eine neutrale oder spezifische Kulturressourcendatei kann bearbeitet werden, um die Eigenschaften der Benutzeroberfläche des Formulars oder des Steuerelements zu ändern, z. B. Text, Größe und Position.

  • Neutrale oder spezifische Kulturressourcendateien können aus der Standardressourcendatei generiert werden.

  • Eine Kulturressourcendatei kann als andere Kulturressourcendatei gespeichert werden. So kann z. B. eine Ressourcendatei für Englisch (USA) als Ressourcendatei für Polnisch gespeichert werden. I. d. R. wird die neue Datei bearbeitet, damit sie mit der neuen Kultur kompatibel ist.

Hierarchische Organisation der Ressourcen für die Lokalisierung
Hierarchische Organisation der Ressourcen für die Lokalisierung
Hierarchische Organisation der Ressourcen für die Lokalisierung
Hierarchische Organisation der Ressourcen für die Lokalisierung

Winres.exe kann keine RESX-Datei in die zugehörige RESOURCES-Datei konvertieren. Verwenden Sie dazu das Tool Resgen.exe. Weitere Informationen zu Resgen.exe finden Sie unter Resource File Generator (Resgen.exe).

Winres.exe ist eine grafische Anwendung, die eine Entwurfszeitversion eines Windows Forms-Formulars aus der Ressourcendatei ohne Zugriff auf den Quellcode neu erstellt. Winres.exe stellt den Windows Forms-Designer und das Eigenschaftenfenster von Visual Studio bereit. Mithilfe dieser Features ist die visuelle Bearbeitung einer RESOURCES- oder RESX-Datei möglich, die ein Windows Forms-Formular enthält. Lokalisierungsexperten verwenden Winres.exe, um Steuerelementbeschriftungen zu bearbeiten und die Position und Größe der einzelnen Steuerelemente so anzupassen, dass die Beschriftungen in der Zielsprache ordnungsgemäß angezeigt werden.

Wenn Winres.exe einen bestimmten Steuerelementtyp nicht auflösen kann, wird ein Platzhaltersteuerelement in der lokalisierten RESX- bzw. RESOURCES-Datei erstellt. Das Platzhaltersteuerelement wird im Windows Forms-Formular als schraffiertes Fenster angezeigt. Die Größe und Position des schraffierten Fensters entsprechen der des Steuerelements selbst. Alle verfügbaren lokalisierbaren Eigenschaften für das Platzhaltersteuerelement werden im Eigenschaftenfenster angezeigt. Am Platzhaltersteuerelement vorgenommene Änderungen werden im Steuerelement selbst gespeichert.

Winres.exe im Vergleich zu Visual Studio

Bevor Sie mit dem Lokalisieren der Windows Forms-Formulare einer Anwendung beginnen, sollten Sie sich für eines der Lokalisierungstools Visual Studio bzw. Winres.exe entscheiden. Aus Gründen der Versionskompatibilität, wie später beschrieben, können Sie u. U. nicht zwischen den beiden Tools wechseln.

Der Vorteil von Visual Studio besteht darin, dass Sie dieses Tool sowohl zum Entwickeln als auch zum Lokalisieren einer Anwendung verwenden können. Um ein Formular nach Abschluss der Entwicklung zu lokalisieren, legen Sie die LocalizableAttribute-Eigenschaft des Formulars (Localizable-Eigenschaft im Eigenschaften-Editor) auf true fest und ändern die Language-Eigenschaft in die gewünschte Zielkultur. Bearbeiten Sie dann die Zeichenfolgen und passen Sie die Position und Größe der Steuerelemente an, damit die Zeichenfolgen der Zielkultur ordnungsgemäß angezeigt werden. Wenn Sie die lokalisierte RESX-Datei speichern, schreibt Visual Studio nur die lokalisierbaren Eigenschaften (d. h. diejenigen Eigenschaften, die sich in der Zielkultur geändert haben) in die Datei. Visual Studio erstellt automatisch eine Satellitenassembly für die lokalisierte RESX-Datei im richtigen Verzeichnis. Exemplarische Vorgehensweise: Lokalisieren von Windows Forms
Exemplarische Vorgehensweise: Lokalisieren von Windows Forms
Exemplarische Vorgehensweise: Lokalisieren von Windows Forms
Exemplarische Vorgehensweise: Lokalisieren von Windows Forms
Exemplarische Vorgehensweise: Lokalisieren von Windows Forms

Obwohl in Visual Studio eine integrierte Entwicklungs- und Lokalisierungsumgebung zur Verfügung steht, wird für die Lokalisierung durch Lokalisierungsexperten von Drittanbietern die Verwendung von Winres.exe empfohlen. Winres.exe ist ein reines Lokalisierungstool und ermöglicht daher eine sauberere Trennung des Anwendungscodes von den zu lokalisierenden Formularen und ist daher für die Verwaltung umfangreicher Projekte besser geeignet ist.

Verwenden von Winres.exe

Um mithilfe von Winres.exe zu lokalisieren, müssen Sie zunächst unter Verwendung eines visuellen Designers, wie Forms-Designer in Visual Studio, eine Anwendung entwickeln. Wenn die Entwicklung beendet ist, legen Sie LocalizableAttribute-Eigenschaft des Formulars (die Localizable-Eigenschaft im Eigenschaften-Editor) auf true fest und leiten dann die RESX-Datei für die Standardkultur an den Lokalisierungsexperten eines Drittanbieters weiter. Diese RESX-Datei enthält zusätzliche Informationen, mit deren Hilfe Winres.exe eine Entwurfszeitversion des Originalformulars erstellt.

Warnung

Winres.exe ist nicht zum Bearbeiten der Standardressourcendatei geeignet. Winres.exe interpretiert alle geänderten Eigenschaften als lokalisierte Eigenschaften und speichert diese in der Ressourcendatei für die Zielkultur.

Mithilfe der endgültigen Versionen der Kulturressourcendateien können lokalisierte Versionen der Anwendung erstellt werden. Weitere Informationen hierzu finden Sie unter Ressourcen in Anwendungen.

Version 2.0 von Winres.exe weist die folgenden Features und Fähigkeiten auf:

  • Winres kann im Einzeldateimodus oder im Visual Studio-Dateimodus ausgeführt werden. Der Einzeldateimodus ist der Legacymodus, in dem umfassende Informationen zu dem Formular und dem zugehörigen Inhalt in der Ressourcendatei gespeichert werden. Im Visual Studio-Modus werden nur kulturelle Änderungen in der Ressourcendatei gespeichert.

  • Der Oberfläche wurde in der linken unteren Ecke des Hauptfensters ein Fehlerberichtfenster hinzugefügt.

  • Hotkeys können auf Duplikate überprüft werden: Klicken Sie im Menü Format auf den Befehl HotKeys überprüfen.

Versionskompatibilität

Da das Format der Ressourcendateien zwischen Visual Studio .NET 2002 und Visual Studio 2005 geändert wurde, wurde auch Winres.exe aus Kompatibilitätsgründen geändert. Sie sollten daher stets die Version von Winres.exe verwenden, die mit der Version von .NET Framework veröffentlicht wurde, mit der Sie die Anwendung erstellen. Die kompatiblen Versionen sind in der folgenden Tabelle aufgelistet.

Visual Studio .NET Framework Winres.exe

Visual Studio .NET 2002

1.0

1.0

Visual Studio .NET 2003

1.1

1.1

Visual Studio 2005

2.0

2.0

Wenn Sie versuchen, eine ältere Ressourcendatei mit Version 2.0 von Winres.exe zu öffnen, werden Sie aufgefordert, das Format der Datei zu aktualisieren, damit diese mit Version 2.0 von .NET Framework kompatibel ist.

In Versionen von .NET Framework vor Version 2.0 haben Winres.exe und der Forms-Designer in Visual Studio inkompatible kulturneutrale und kulturspezifische Ressourcendateien erstellt. Daher konnten Sie nach Beginn des Lokalisierungsprozesses nur noch ein Tool verwenden. Mit Version 2.0 von Winres.exe wurde jedoch der Visual Studio-Dateimodus hinzugefügt. Wie der Name impliziert, kann eine in diesem Kompatibilitätsmodus gespeicherte Ressourcendatei mit einem von beiden Tools bearbeitet werden.

Hinweis

Obwohl der Visual Studio-Dateimodus den Vorteil der Kompatibilität mit Visual Studio bietet, da in ihm nur geänderte Werte in der Ressourcendatei gespeichert werden, müssen sich für Winres.exe die übergeordneten Elemente der aktuellen Ressourcendatei im selben Verzeichnis befinden. Wenn Sie beispielsweise TestApp.de-DE.resources für eine Ressourcendatei für Deutsch (Deutschland) bearbeiten möchten, muss die Standardressourcendatei, TestApp.resx, und möglicherweise auch die kulturneutrale Ressourcendatei, TestApp.de.resources, vorliegen.

Beispiele

So lokalisieren Sie eine mit einem Formular verknüpfte RESX- oder RESOURCES-Datei

  1. Geben Sie an der Eingabeaufforderung winres ein, um Winres.exe auszuführen.

  2. Um die Standardressourcen für ein zu lokalisierendes Formular zu öffnen, klicken Sie im Menü Datei auf den Befehl Öffnen, und navigieren Sie zu der zu öffnenden Datei.

    - oder -

    Geben Sie die zu öffnende Datei beim Starten von Winres.exe in der Befehlszeile an.

    Der folgende Befehl startet Winres.exe und lädt das mit TestApp.resx verknüpfte Formular in den Designer.

    winres TestApp.resx

    Der folgende Befehl startet Winres.exe und lädt das mit TestApp.resources verknüpfte Formular in den Designer.

    winres TestApp.resources

    Hinweis

    Wenn das Formular, dessen Ressourcen Sie bearbeiten, ein geerbtes Formular ist, muss sowohl die im geerbten Formular enthaltene Assembly als auch die Assembly, die das abgeleitete Formular enthält, im globalen Assemblycache (GAC) registriert sein oder sich im selben Verzeichnis wie WinRes.exe befinden. Weitere Informationen zum Installieren von .NET Framework-Komponenten im GAC finden Sie unter Globaler Assemblycache.

  3. Wählen Sie Steuerelemente auf dem Formular aus, und ändern Sie ihre Text-Eigenschaft und andere Eigenschaften, um die lokalisierte Kultur und die entsprechende Sprache zu reflektieren. Damit der lokalisierte Text ordnungsgemäß angezeigt wird, verschieben Sie die Steuerelemente bei Bedarf bzw. ändern ihre Größe.

  4. Um die lokalisierte Version der RESX- bzw. RESOURCES-Datei zu speichern, klicken Sie auf das Symbol Save oder im Menü Datei auf den entsprechenden Befehl. Das Fenster Kultur auswählen wird angezeigt.

  5. Wählen Sie die entsprechende Kultur und den entsprechenden Dateimodus aus, und klicken Sie dann auf OK. Die Datei wird gespeichert, wobei die Benennungskonvention verwendet wird, die die Laufzeit für lokalisierte Ressourcendateien erwartet. Wenn Sie beispielsweise TestApp.resources für Deutsch (Deutschland) lokalisieren, speichert das Tool die Datei als TestApp.de-DE.resources. Wenn Sie TestApp.resx für Deutsch (Deutschland) lokalisieren, speichert das Tool die Datei als TestApp.de-DE.resx. Weitere Informationen zu Benennungskonventionen für Ressourcen finden Sie unter Verpacken und Bereitstellen von Ressourcen. Eine Liste der durch die Laufzeit verwendeten vordefinierten Kulturnamen finden Sie unter CultureInfo Class.

Siehe auch

Referenz

.NET Framework-Tools
LocalizableAttribute
CultureInfo
ResourceManager
ResourceReader
ResourceWriter

Konzepte

Ressourcen in Anwendungen

Weitere Ressourcen

Codierung und Lokalisierung