リソースマニフェストファイルの名前付け方法

2025-06-22

MSBuild が .NET Core プロジェクトをコンパイルすると、 .resx ファイル拡張子を持つ XML リソースファイルがバイナリ .resources ファイルに変換されます。バイナリファイルはコンパイラの出力に埋め込まれており、 ResourceManagerで読み取ることができます。この記事では、MSBuild で各 .resources ファイルの名前を選択する方法について説明します。

ヒント

プロジェクトファイルにリソース項目を明示的に追加し、. NET Core の既定のインクルード glob にも含まれている場合は、ビルドエラーが発生します。リソースファイルを EmbeddedResource 項目として手動で含めるには、 EnableDefaultEmbeddedResourceItems プロパティを false に設定します。

既定の名前

.NET Core 3.0 以降では、次の両方の条件が満たされている場合、リソースマニフェストの既定の名前が使用されます。

リソースファイルは、EmbeddedResource、LogicalName、またはManifestResourceNameメタデータを含むDependentUpon項目としてプロジェクトファイルに明示的に含まれません。
EmbeddedResourceUseDependentUponConvention プロパティは、プロジェクトファイルでfalseに設定されていません。既定では、このプロパティは trueに設定されています。詳細については、EmbeddedResourceUseDependentUponConventionを参照してください。

リソースファイルが同じルートファイル名のソースファイル (.cs または .vb) と併置されている場合、ソースファイルで定義されている最初の種類の完全な名前がマニフェストファイル名に使用されます。たとえば、 MyNamespace.Form1 が Form1.csで定義された最初の型であり、 Form1.cs が Form1.resx と併置されている場合、そのリソースファイルに対して生成されるマニフェスト名は MyNamespace.Form1.resources になります。

LogicalName メタデータ

リソースファイルが、EmbeddedResourceメタデータを持つLogicalName項目としてプロジェクトファイルに明示的に含まれている場合、LogicalName値がマニフェスト名として使用されます。 LogicalName は、他のメタデータまたは設定よりも優先されます。

たとえば、次のプロジェクトファイルスニペットで定義されているリソースファイルのマニフェスト名は SomeName.resources です。

<EmbeddedResource Include="X.resx" LogicalName="SomeName.resources" />

-又は-

<EmbeddedResource Include="X.fr-FR.resx" LogicalName="SomeName.resources" />

注

LogicalNameが指定されていない場合、ファイル名に 2 つのドット (EmbeddedResource) を持つ.は機能しません。つまり、GetManifestResourceNamesはそのファイルを返しません。

次の例は正しく動作します。
```
<EmbeddedResource Include="X.resx" />
```
次の例は機能しません。
```
<EmbeddedResource Include="X.fr-FR.resx" />
```

ManifestResourceName メタデータ

リソースファイルがEmbeddedResourceメタデータを持つManifestResourceName項目としてプロジェクトファイルに明示的に含まれている場合 (およびLogicalNameが存在しない場合)、ファイル拡張子 ManifestResourceName と組み合わせた値がマニフェストファイル名として使用されます。

たとえば、次のプロジェクトファイルスニペットで定義されているリソースファイルのマニフェスト名は SomeName.resources です。

<EmbeddedResource Include="X.resx" ManifestResourceName="SomeName" />

次のプロジェクトファイルスニペットで定義されているリソースファイルのマニフェスト名は SomeName です。.resourcesfr-FR。

<EmbeddedResource Include="X.fr-FR.resx" ManifestResourceName="SomeName.fr-FR" />

DependentUpon メタデータ

リソースファイルがEmbeddedResourceメタデータを持つDependentUpon項目としてプロジェクトファイルに明示的に含まれている場合 (また、LogicalNameとManifestResourceNameが存在しない場合)、リソースマニフェストファイル名には、DependentUponによって定義されたソースファイルの情報が使用されます。具体的には、ソースファイルで定義されている最初の型の名前は、次のようにマニフェスト名で使用されます: Namespace.Classname[。Culture].resources。

たとえば、次のプロジェクトファイルスニペットで定義されているリソースファイルのマニフェスト名は Namespace.Classname.resources です ( Namespace.Classname は 、MyTypes.csで定義されている最初のクラスです)。

<EmbeddedResource Include="X.resx" DependentUpon="MyTypes.cs">

次のプロジェクトファイルスニペットで定義されているリソースファイルのマニフェスト名は Namespace.Classname です。.resourcesfr-FR ( Namespace.Classname は 、MyTypes.csで定義されている最初のクラスです)。

<EmbeddedResource Include="X.fr-FR.resx" DependentUpon="MyTypes.cs">

EmbeddedResourceUseDependentUponConvention プロパティ

EmbeddedResourceUseDependentUponConventionがプロジェクトファイルでfalseに設定されている場合、各リソースマニフェストファイル名は、プロジェクトのルート名前空間と、プロジェクトルートから .resx ファイルへの相対パスに基づきます。具体的には、生成されるリソースマニフェストファイル名は RootNamespace.RelativePathWithDotsForSlashes です。[Culture.]リソース。これは、3.0 より前のバージョンの .NET Core でマニフェスト名を生成するために使用されるロジックでもあります。

注

RootNamespaceが定義されていない場合、既定値はプロジェクト名になります。
プロジェクトファイル内のLogicalName項目にManifestResourceName、DependentUpon、またはEmbeddedResourceメタデータが指定されている場合、この名前付け規則はそのリソースファイルには適用されません。

次の方法で共有

リソース マニフェスト ファイルの名前付け方法