Winres.exe (Windows Resource Localization Editor)

[アーティクル]
05/26/2023

Windows Resource Localization Editor (Winres.exe) は、ビジュアルレイアウトツールです。ローカリゼーションの専門家は、このツールにより、フォームで使用される Windows フォームのユーザーインターフェイス (UI) リソースのローカライズが楽になります。 Winres.exe への入力として使用される .resx ファイルおよび .resources ファイルは、Microsoft Visual Studio などのビジュアルデザイン環境を使用して作成できます。 .NET Framework アプリケーションにリソースを配置する方法については、「.NET アプリのリソース」を参照してください。

Winres.exe が Visual Studio と共にインストールされます。ツールを実行するには、、Visual Studio 開発者コマンドプロンプトまたは Visual Studio Developer PowerShell を使用します。

警告

信頼されていないファイルはこのツールで開かないでください。ファイルがバイナリファイルの場合、安全ではないバイナリ逆シリアル化によって逆シリアル化されます。詳細については、「BinaryFormatter および関連する型を使用するときの逆シリアル化のリスク」を参照してください。

構文

winres resourceFile
winres /?

引数

引数	説明
`resourceFile`	ローカライズするリソースファイル。このファイルは Visual Studio デザイナーで作成した、Windows フォームの .resx ファイルまたは .resources ファイルである必要があります。 Winres.exe では、汎用的な .resx ファイルまたは .resources ファイルは開くことができません。

オプション	説明
/?	このツールのコマンド構文とオプションを表示します。

Remarks

Windows フォームプロジェクトのフォームの UI 要素の状態は、通常、リソースファイルに格納されます。リソースファイルは、拡張子 .resx を持つ XML ベースのファイル、または、これに対応する、拡張子 .resources が設定された、コンパイル済みのバイナリ形式のファイルのいずれかです。 Winres.exe ツールでは、上記いずれかの形式のファイルを、Visual Studio のデザイン環境を使用しないで編集できますが、制限があります。具体的には、以下の編集操作を行うことができます。

ニュートラルまたは特定のカルチャリソースファイルを編集して、テキスト、サイズ、位置など、フォームやそのコントロールの UI プロパティを変更できます。
ニュートラルまたは特定のカルチャのリソースファイルを、既定のリソースファイルから作成できます。
カルチャリソースファイルを別のカルチャのリソースファイルとして保存できます。たとえば、英語 (U.S.) のリソースファイルを、ポーランド語のリソースファイルとして保存できます。通常は、新しいファイルを引き続き編集して、新しいカルチャに対応させます。

「ローカリゼーション用リソースの階層編成」または「ローカリゼーション用リソースの階層編成」も参照してください。

Winres.exe では、対応する .resources ファイルに .resx ファイルを変換できません。この場合は Resgen.exe ツールを使用してください。 Resgen.exe について詳しくは、「Resgen.exe (リソースファイルジェネレーター)」を参照してください。

Winres.exe はグラフィカルアプリケーションであり、ソースコードにアクセスすることなく、リソースファイルだけを使用して、Windows フォームのデザイン時バージョンを再作成できます。 Winres.exe では、Visual Studio の Windows フォームデザイナーおよび [プロパティ] ウィンドウがホストされます。この機能を使用すると、Windows フォームが含まれている .resources ファイルや .resx ファイルをビジュアル編集できます。通常、ローカライズツールでは Winres.exe を使用して、コントロールのラベルが編集されると共に、ターゲットカルチャのラベルが納まるようにコントロールの位置とサイズが調整されます。

Winres.exe がコントロールの型を解決できない場合、ローカライズされた .resx ファイルまたは .resources ファイルには、プレースホルダーコントロールが作成されます。このプレースホルダーコントロールは、Windows フォーム上にハッチウィンドウとして表示されます。このハッチウィンドウのサイズおよび位置は、実際のコントロールのサイズおよび位置と一致します。プレースホルダーコントロールのプロパティでローカライズできるプロパティはすべて、 [プロパティ] ウィンドウに表示されます。プレースホルダーコントロールに対して行ったすべての変更内容が、実際のコントロールに保存されます。

Winres.exe と Visual Studio の比較

通常、アプリケーションの Windows フォームのローカライズを開始する前に、ローカリゼーションツールとして Visual Studio と Winres.exe のどちらを使用するのかを決定する必要があります。この後で説明するバージョンの互換性の問題が原因で、途中でツールを切り替えることができない場合があるためです。

Visual Studio の利点は、アプリケーションの開発にもローカライズにも使用できる点です。フォームをローカライズするには、開発を完了してから、フォームの LocalizableAttribute (プロパティ エディター内の Localizable プロパティ) を true に設定し、その Language プロパティを目的のカルチャに変更します。次に、文字列を編集し、ターゲットカルチャに合わせて変更した文字列が納まるようにコントロールの位置およびサイズを調整します。ローカライズ済み .resx file を保存するときに、Visual Studio は、ローカライズ可能なプロパティ (ターゲットカルチャで変更したプロパティ) だけをファイルに書き込みます。 Visual Studio は、ローカライズ済み .resx ファイル用のサテライトアセンブリを正しいディレクトリ位置に自動的に作成します。

Visual Studio には、開発およびローカリゼーション用の統合環境が用意されていますが、ローカリゼーションがサードパーティのローカライズツールによって行われる場合には Winres.exe をツールとして使用することをお勧めします。 Winres.exe はローカリゼーション専用のツールであるため、アプリケーションのコードとローカライズ対象のフォームを明確に分離でき、大規模なプロジェクトを管理するうえでより実用的です。

Winres.exe の使用

Winres.exe を使用してローカライズを行う場合は、まず、Visual Studio 内の Windows フォームデザイナー などのビジュアルデザイナーを使用してアプリケーションを開発する必要があります。開発が完了したら、フォームの LocalizableAttribute (プロパティエディター内の Localizable プロパティ) を true に設定し、既定のカルチャの .resx ファイルを、サードパーティのローカライズツールに渡します。この .resx ファイルには、Winres.exe が元のフォームのデザイン時バージョンを再作成するために使用する補足情報が含まれています。

Note

Winres.exe で既定のリソースファイルを編集することはできません。 Winres.exe では、変更されたすべてのプロパティがローカライズされたプロパティと解釈され、ターゲットカルチャリソースファイルに保存されます。

カルチャリソースファイルの最終バージョンが完成したら、これを使用して、アプリケーションのローカライズバージョンを作成できます。詳細については、「.NET アプリのリソース」を参照してください。

Winres.exe には、以下の機能があります。

Winres は、単一ファイルモード (SFM: Single File Mode) または Visual Studio ファイルモード (VSFM: Visual Studio File Mode) で使用できます。 SFM は、フォームとその内容についての情報すべてをリソースファイルに格納する、レガシなモードです。 VSFM では、カルチャの変更点のみがリソースファイルに格納されます。
エラーレポートウィンドウがメインウィンドウの左下にドッキングされます。
ホットキーの重複をチェックできます。 [書式] メニューの [ホットキーの確認] コマンドをクリックします。

バージョンの互換性

使用している .NET Framework と共にリリースされた Winres.exe のバージョンを使用する必要があります。次の表は、互換性のあるバージョンの一覧です。

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
Visual Studio 2008	3.0 と 3.5	3.0 と 3.5
Visual Studio 2010	4.0	4.0
Visual Studio 2017	4.6	4.6

Note

VSFM には、Visual Studio 互換であるという長所がありますが、変更点だけをリソースファイルに格納するため、Winres.exe で VSFM を使用するには、現在のリソースファイルの親ファイルが同じディレクトリに存在する必要があります。たとえば、ドイツ語のリソースファイル TestApp.de-DE.resources を編集している場合は、既定のリソースファイル TestApp.resx が存在する必要があり、ときにはカルチャニュートラルなリソースファイル TestApp.de.resources も必要となることがあります。

使用例

フォームに関連付けられた .resx ファイルまたは .resources ファイルをローカライズするには

Winres.exe を実行するには、開発者コマンドプロンプトで「winres」と入力します。
ローカライズするフォームの既定のリソースを開くには、[ファイル]、[開く] の順に選択し、ファイルに移動してそれを開きます。

\- または -

Winres.exe を起動するときに、コマンドラインで開くファイルを指定します。次のコマンドは、Winres.exe を起動し、TestApp.resx に関連付けられたフォームをフォームデザイナーに読み込みます。
```
winres TestApp.resx
```
次のコマンドは、Winres.exe を起動し、TestApp.resources に関連付けられたフォームをフォームデザイナーに読み込みます。
```
winres TestApp.resources
```
Note

リソースが編集中であるフォームが他のフォームを継承したフォームである場合は、継承したフォームを含むアセンブリと、継承元 (派生元) のフォームを含むアセンブリの両方が、グローバルアセンブリキャッシュ (GAC: Global Assembly Cache) に登録されているか、WinRes.exe と同じディレクトリに存在する必要があります。 .NET Framework のコンポーネントを GAC にインストールする方法の詳細については、「グローバルアセンブリキャッシュ」を参照してください。
フォーム上のコントロールを選択し、このコントロールの Text などのプロパティを変更して、ローカライズ後のカルチャおよび言語を反映します。ローカライズされたテキストが納まるように、必要に応じてコントロールを移動したりそのサイズを変更したりします。
.resx または .resources ファイルのローカライズされたバージョンを保存するには、[保存] アイコンをクリックするか、[ファイル]、[保存] の順に選択します。 [カルチャを選択する] ウィンドウが表示されます。
適切なカルチャおよびファイルモードを選択し、 [OK] をクリックします。

ツールによってファイルが保存される場合は、ローカライズされたリソースファイルに対してランタイムが予測した名前付け規則が使用されます。たとえば、TestApp.resources をドイツのドイツ語用にローカライズする場合、ファイルは TestApp.de-DE.resources という名前で保存されます。 TestApp.resx をドイツのドイツ語用にローカライズする場合、ファイルは TestApp.de-DE.resx という名前で保存されます。リソースの名前付け規則の詳細については、リソースのパッケージ化と配置に関するページを参照してください。ランタイムで使用される定義済みカルチャ名の一覧については、「CultureInfo クラス」を参照してください。

次の方法で共有