Winres.exe (Windows Resource Localization Editor)

Der Windows-Ressourcenlokalisierungs-Editor Winres.exeist ein visuelles Layouttool, mit dem Lokalisierungsexperten die von Formularen verwendeten Windows Forms-Benutzeroberflächenressourcen lokalisieren können. Sie können die RESX - oder RESSOURCENdateien erstellen, die als Eingabe verwendet werden, um Winres.exe mithilfe einer visuellen Entwurfsumgebung wie Microsoft Visual Studio zu Winres.exe. Informationen zum Bereitstellen von Ressourcen in .NET Framework-Anwendungen finden Sie unter Ressourcen in .NET-Apps.

Winres.exe wird mit Visual Studio installiert. Verwenden Sie zum Ausführen des Tools die Visual Studio Developer-Eingabeaufforderung oder Visual Studio Developer PowerShell.

Syntax

winres resourceFile
winres /?

Arguments

Bemerkungen

Der Status von UI-Elementen aus einem Formular in einem Windows Forms-Projekt wird in der Regel in Ressourcendateien gespeichert, die entweder XML-basierte Dateien mit der Erweiterung RESX oder die entsprechenden kompilierten, binären Versionen mit der Erweiterung .resources sind. Winres.exe ist ein Tool, das die eingeschränkte Bearbeitung von Dateitypen außerhalb der Visual Studio-Entwurfsumgebung ermöglicht. Insbesondere ermöglicht sie die folgenden Arten von Bearbeitungsvorgängen:

• Eine neutrale oder bestimmte Kulturressourcendatei kann bearbeitet werden, um die UI-Eigenschaften des Formulars oder der zugehörigen Steuerelemente wie Text, Größe oder Position zu ändern.
• Neutrale oder bestimmte Kulturressourcendateien können aus der Standardressourcendatei generiert werden.
• Eine Kulturressourcendatei kann als eine andere Kulturressourcendatei gespeichert werden. Eine Ressourcendatei für Englisch (USA) könnte z. B. als polnische Ressourcendatei gespeichert werden. In der Regel würde die neue Datei anschließend bearbeitet, um mit der neuen Kultur kompatibel zu sein.

Siehe auch hierarchische Organisation von Ressourcen für Lokalisierung oder hierarchische Organisation von Ressourcen für die Lokalisierung.

Winres.exe kann keine RESX-Datei in die entsprechende RESSOURCEN-Datei konvertieren; verwenden Sie stattdessen das Resgen.exe Tool. Weitere Informationen zu Resgen.exefinden Sie unter Resgen.exe (Ressourcendateigenerator).

Winres.exe ist eine grafische Anwendung, die eine Entwurfszeitversion eines Windows Forms-Formulars aus nur der Ressourcendatei neu erstellt, ohne Zugriff auf den Quellcode zu haben. Winres.exe hosten den Windows Forms Form Designer und Properties das Fenster von Visual Studio. Diese Features ermöglichen die visuelle Bearbeitung einer RESSOURCEN- oder RESX-Datei, die ein Windows Forms-Formular enthält. In der Regel verwenden Lokalisierer Winres.exe zum Bearbeiten von Steuerelementbeschriftungen und zum Anpassen der Position und Größe von Steuerelementen, um die Bezeichnungen für die Zielkultur aufzunehmen.

Wenn Winres.exe den Typ eines Steuerelements nicht auflösen kann, wird ein Platzhaltersteuerelement in der lokalisierten RESX- oder RESSOURCEN-Datei erstellt. Das Platzhaltersteuerelement wird im Windows Forms-Formular als geschlüpftes Fenster angezeigt. Die Größe und Position des geschlüpften Fensters entspricht dem des tatsächlichen Steuerelements. Alle verfügbaren lokalisierbaren Eigenschaften für das Platzhaltersteuerelement werden im Properties Fenster angezeigt. Alle Änderungen, die Sie am Platzhaltersteuerelement vornehmen, werden für das tatsächliche Steuerelement gespeichert.

Winres.exe im Vergleich zu Visual Studio

Im Allgemeinen sollten Sie vor dem Lokalisieren der Windows Forms-Formulare einer Anwendung entscheiden, ob Sie Visual Studio oder Winres.exe als Lokalisierungstool verwenden möchten. Die Versionskompatibilität kann, wie später beschrieben, verhindern, dass Sie von einem Tool zum anderen wechseln.

Der Vorteil von Visual Studio besteht darin, dass Sie es zum Entwickeln und Lokalisieren einer Anwendung verwenden können. Um ein Formular zu lokalisieren, legen Sie nach Abschluss der Entwicklung die Formulars LocalizableAttribute (die Localizable Eigenschaft im Properties Editor) auf true die gewünschte Zielkultur fest, und ändern Sie die Language Eigenschaft in die gewünschte Zielkultur. Bearbeiten Sie dann Zeichenfolgen, und passen Sie die Position und Größe von Steuerelementen an, um die Zeichenfolgen für die Zielkultur aufzunehmen. Wenn Sie die lokalisierte RESX-Datei speichern, schreibt Visual Studio nur die lokalisierbaren Eigenschaften (Eigenschaften, die in der Zielkultur geändert wurden) in die Datei. Visual Studio erstellt automatisch eine Satellitenassembly für die lokalisierte RESX-Datei am richtigen Verzeichnisspeicherort.

Obwohl Visual Studio eine integrierte Entwicklungs- und Lokalisierungsumgebung bereitstellt, ist Winres.exe das empfohlene Tool, das verwendet werden soll, wenn die Lokalisierung von Lokalisierern von Drittanbietern erfolgt. Da es sich bei Winres.exe nur um ein Lokalisierungstool handelt, kann der Code einer Anwendung besser von den zu lokalisierenden Formularen getrennt werden, was für die Verwaltung großer Projekte praktischer ist.

Verwenden von Winres.exe

Um die Verwendung von Winres.exezu lokalisieren, müssen Sie zunächst eine Anwendung mit einem visuellen Designer wie dem Windows Forms-Designer in Visual Studio entwickeln. Wenn die Entwicklung abgeschlossen ist, legen Sie die Formular LocalizableAttribute (die Localizable Eigenschaft im Properties Editor) auf trueund übergeben sie dann die RESX-Datei für die Standardkultur an einen Drittanbieter-Lokalisierer. Diese RESX-Datei enthält zusätzliche Informationen, die Winres.exe verwendet, um eine Entwurfszeitversion des ursprünglichen Formulars neu zu erstellen.

Die endgültigen Versionen der Kulturressourcendateien können schließlich verwendet werden, um lokalisierte Versionen der Anwendung zu erstellen. Weitere Informationen finden Sie unter Ressourcen in .NET-Apps.

Winres.exe verfügt über die folgenden Features und Funktionen:

• Winres kann im Einzeldateimodus (Single File Mode, SFM) oder im Visual Studio-Dateimodus (VSFM) ausgeführt werden. SFM ist der Legacymodus, in dem vollständige Informationen zum Formular und dessen Inhalt in der Ressourcendatei gespeichert werden. VSFM speichert nur die kulturellen Änderungen in der Ressourcendatei.

• Ein Fehlerberichtsfenster, das links unten im Hauptfenster verankert ist.

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

Versionskompatibilität

Sie sollten die Version von Winres.exe verwenden, die mit .NET Framework veröffentlicht wurde, die Sie verwenden. In der folgenden Tabelle sind die kompatiblen Versionen aufgeführt:

Examples

So lokalisieren Sie eine RESX- oder RESSOURCEN-Datei, die einem Formular zugeordnet ist

1. Um Winres.exeauszuführen, geben Sie winres die Eingabeaufforderung für Entwickler ein.

2. Um die Standardressourcen für ein Formular zum Lokalisieren zu öffnen, wählen Sie "Datei > öffnen " aus, und navigieren Sie zu der Datei, um sie zu öffnen.

   -oder-

   Geben Sie die Datei an, die an der Befehlszeile geöffnet werden soll, wenn Sie Winres.exestarten. Der folgende Befehl startet Winres.exe und lädt das im Formular-Designer zugeordnete TestApp.resx Formular.

   winres TestApp.resx
   

   Der folgende Befehl startet Winres.exe und lädt das im Formular-Designer zugeordnete TestApp.resources Formular.

   winres TestApp.resources
   

   Hinweis

   Wenn es sich bei dem Formular, dessen Ressourcen Sie bearbeiten, um ein geerbtes Formular handelt, muss sowohl die Assembly das geerbte Formular als auch die Assembly mit dem erbenden (abgeleiteten) Formular entweder im globalen Assemblycache (GAC) registriert werden oder sich im selben Verzeichnis wie WinRes.exebefinden. Weitere Informationen zum Installieren von .NET Framework-Komponenten in das GAC finden Sie unter Global Assembly Cache.

3. Wählen Sie Steuerelemente im Formular aus, und ändern Sie ihre Text und andere Eigenschaften, um die lokalisierte Kultur und ihre Sprache widerzuspiegeln. Verschieben oder ändern Sie die Größe von Steuerelementen nach Bedarf, um den lokalisierten Text aufzunehmen.

4. Um die lokalisierte Version der RESX- oder RESSOURCEN-Datei zu speichern, klicken Sie auf das Save Symbol, oder wählen Sie "Datei speichern" > aus. Das Tool zeigt das Fenster " Kultur auswählen " an.

5. Wählen Sie die entsprechende Kultur und den Dateimodus aus, und klicken Sie dann auf "OK".

   Das Tool speichert die Datei mithilfe der Benennungskonvention, die von der Laufzeit für lokalisierte Ressourcendateien erwartet wird. Wenn Sie beispielsweise für Deutsch in Deutschland lokalisieren TestApp.resources , speichert das Tool die Datei als TestApp.de-DE.resources. Wenn Sie für Deutsch in Deutschland lokalisieren TestApp.resx , speichert das Tool die Datei als TestApp.de-DE.resx. Weitere Informationen zu Ressourcenbenennungskonventionen finden Sie unter "Packen und Bereitstellen von Ressourcen". Eine Liste der vordefinierten Kulturnamen, die von der Laufzeit verwendet werden, finden Sie in der CultureInfo Klasse.

Siehe auch

• LocalizableAttribute
• CultureInfo
• ResourceManager
• ResourceReader
• ResourceWriter
• Werkzeuge
• Ressourcen in .NET-Apps
• Globalisierung und Lokalisierung