リソース ファイルは、アプリケーションの一部であるが、コンパイルされていないファイル (アイコン ファイルやオーディオ ファイルなど) です。 これらのファイルはコンパイル プロセスの一部ではないため、バイナリを再コンパイルしなくても変更できます。 アプリケーションのローカライズを計画している場合は、アプリケーションをローカライズするときに変更する必要があるすべての文字列とその他のリソースにリソース ファイルを使用する必要があります。
注意事項
.resx
ファイル内のリソースは、BinaryFormatter
を使用してシリアル化できます。セキュリティで保護。 信頼できるビルド プロセスに .resx
ファイルのみを含めます。
.NET アプリのリソースの詳細については、「.NET アプリ のリソース」を参照してください。
リソースと協力する
マネージド コード プロジェクトで、プロジェクトのプロパティ ウィンドウを開きます。 プロパティ ウィンドウは、次のいずれかの方法で開くことができます。
- ソリューション エクスプローラーでプロジェクト ノードを右クリックし、[プロパティ] を選択する
- Ctrl+ 検索ボックスにプロジェクトのプロパティを入力する
- ソリューション エクスプローラーで + キーEnter キーを押す
[ リソース ] タブを選択します。プロジェクトにまだ .resx ファイルが含まれていない場合は、.resx ファイルを追加し、さまざまな種類のリソースを追加および削除し、既存のリソースを変更できます。
Visual Studio 2022 以降でのリソース エクスプローラーの機能強化
Visual Studio 2022 バージョン 17.11 以降では、リソース エクスプローラーが大幅に改善されました。 「 改良された Visual Studio リソース エクスプローラーの概要」を参照してください。
新しいリソース エクスプローラーを使用するには、1 つ以上のリソース ファイル (.resx
) を含む .NET プロジェクトが必要です。 リソース エクスプローラーを開くには、ソリューション エクスプローラーで任意のリソース ファイルを右クリックし、[ 開く>リソース エクスプローラー] を選択します。 または、キーボード ショートカット Ctrl+Alt+R を使用することもできます。
新しいリソース エクスプローラーを開くと、左側に、各ファイルのロケールと共に保存したすべてのリソースの概要が表示されます。 データ グリッドに表示するロケールを構成できます。 このインターフェイスを使用すると、翻訳を並べて比較し、その場で編集することができます。
リソース文字列を検索する
グリッドの左上にある検索ボックスを使用して、すべてのリソース ファイルを検索するテキストを実行できます。 リソースを検索するには、ツール バーの検索ボックスに入力し、Enter キーを押します。 データ グリッドには、クエリに一致するリソースのみが名前、値、またはコメントに表示されます。 ワイルドカード (*
) を使用して部分一致を実行し、引用符 ("
) を使用して完全一致を実行できます。
リソースの特定の翻訳にコメントを追加する
コメントは、文字列の意味、使用法、トーンなど、リソースの詳細情報やコンテキストを提供する便利な方法です。 リソース エクスプローラーでは、リソースの各翻訳にコメントを追加し、データ グリッドで一度にすべてを表示できます。
リソースにコメントを追加するには、コメントする翻訳に対応するセルを選択し、ツール バーの [コメントの編集] ボタンをクリックするか、Shift キーを押+Enter キーを押します。 セルの下にコメント ボックスが表示され、コメントを入力できます。 コメントを保存するには Enter キーを押し、破棄するには Esc キー を押します。
コメント ボックスをクリックするか、同じキーボード ショートカットを使用して、既存のコメントを編集または削除できます。 リソースのすべてのコメントを表示するには、コメントがある各セルの隅にある小さな三角形アイコンを探します。 アイコンの上にマウス ポインターを置くと、コメント テキストを含むヒントが表示されるか、クリックしてコメント ボックスが開きます。
コメントは、リソース ファイルの複数のユーザーが使用できます。 翻訳担当者、開発者、またはリソース マネージャーは、翻訳と共にメモ、質問、説明、または注意事項を残すことができます。 各セルの隅にある小さなアイコンは、コメントの存在を示します。
リソースをフィルター処理する
リソースをフィルター処理するには、ツール バーのフィルター アイコンをクリックし、適用する条件を選択します。 リソースは、名前、値、コメント、種類、またはファイルでフィルター処理できます。
フィルター | 説明 |
---|---|
名前 | 特定の名前またはプレフィックスを持つリソースのみを表示します。 |
価値 | 特定の値を持つリソース、または特定の文字列を含むリソースのみを表示します。 |
コメント | コメントがあるリソース、またはコメントに特定の文字列が含まれているリソースのみを表示します。 |
タイプ | 文字列、画像、アイコンなど、特定の種類のリソースのみを表示します。 |
ファイル | 特定のファイルまたはカルチャに属するリソースのみを表示します。 |
複数のフィルターを組み合わせて結果を絞り込み、[フィルターのクリア] ボタンをクリックして結果をクリアできます。
検証と警告
プレースホルダーは、実行時に動的な値 ( {0}
、 {1}
、 {name}
など) に置き換えられる特別なトークンです。 リソースでプレースホルダーを使用する場合は、すべてのローカライズで一貫性があることを確認する必要があります。そうしないと、アプリでエラーや予期しない動作が発生する可能性があります。
新しいリソース エクスプローラーでは、各リソースのプレースホルダーが自動的に検証され、既定のカルチャとその他のローカライズの間に不一致がある場合は警告アイコンが表示されます。 たとえば、リソースの既定値が "Hello, {name}!" で、スペイン語の値が "Hola, {nombre}!" の場合、プレースホルダー名が異なっていることを示す警告アイコンが表示されます。 アイコンの上にマウス ポインターを置くと、不一致の詳細を含むヒントが表示され、それをクリックして修正できます。
翻訳が見つからないというもう 1 つの一般的な問題は、アプリのユーザー エクスペリエンスに影響を与える可能性があります。 特定のカルチャ内のリソースの翻訳を提供しない場合、アプリは既定のカルチャにフォールバックします。これは、一部のユーザーにとって適切ではないか、望ましくない可能性があります。 リソース エクスプローラーは、特定のカルチャ内のリソースに値がない場合に警告アイコンを表示することで、この問題を回避するのに役立ちます。 たとえば> 既定値が File
で、フランス文化の値がないリソースがある場合、翻訳が見つからないことを示す警告アイコンが表示されます。 アイコンの上にマウス ポインターを置くと、値 なし というメッセージが表示されたヒントが表示され、それを選択して値を追加できます。
カスタマイズ オプション
Visual Studio 2022 以降のリソース エクスプローラーはスクリーン リーダーや支援技術と互換性があり、視覚障障穙のある開発者にとってアクセシビリティが高くなります。 キーボード ショートカットを使用すると、データ グリッド内を移動したり、値やコメントを編集したり、一般的な操作を実行したりできます。 ナレーターを使用して、各セルの内容、およびヒントと警告を読み取ることもできます。
ズーム レベルを調整するには、ツール バーのズーム スライダーを使用するか、キーボード ショートカット Ctrl+= および Ctrl+- を使用して拡大または縮小します。ズーム レベルを既定値にリセットするには、 Ctrl+0 キーを使用します。
リソース エクスプローラーのテーマは、Visual Studio 環境の残りの部分と一致しています。 明るいテーマ、濃いテーマ、または青のテーマを選択できます。リソース エクスプローラーはそれに応じて調整されます。 データ グリッドのフォントと色は、[ ツール>オプション>Environment>Fonts と Colors] ダイアログを使用して変更することもできます。
他のプロジェクトの種類のリソース
.NET プロジェクトでは、他のプロジェクトの種類とは異なる方法でリソースが管理されます。 リソースの詳細については、以下を参照してください。
- ユニバーサル Windows プラットフォーム (UWP) アプリ、アプリ リソースとリソース管理システムに関するページを参照してください
- C++/CLI (マネージド) プロジェクト(デスクトップ アプリのリソースを参照)
- C++ プロジェクトの「リソース ファイルの操作」と「方法: リソースを作成する」を参照してください
- リソース ビュー ウィンドウ (ビュー>その他の Windows>Resource ビュー) を使用して、プロジェクトに含まれるリソース ファイルを表示します。
サポート オプション
アプリケーション リソースの管理で問題が発生した場合は、 リソース エディターのエラーのトラブルシューティングを参照してください。