Como os arquivos de manifesto de recursos são nomeados

Artigo
03/02/2024

Quando o MSBuild compila um projeto .NET Core, os arquivos de recursos XML, que têm a extensão de arquivo .resx , são convertidos em arquivos binários .resources . Os arquivos binários são incorporados na saída do compilador e podem ser lidos ResourceManagerpelo . Este artigo descreve como o MSBuild escolhe um nome para cada arquivo .resources .

Gorjeta

Se você adicionar explicitamente um item de recurso ao seu arquivo de projeto e ele também estiver incluído com o padrão include globs para .NET Core, você receberá um erro de compilação. Para incluir manualmente arquivos de recursos como EmbeddedResource itens, defina a EnableDefaultEmbeddedResourceItems propriedade como false.

Nome padrão

No .NET Core 3.0 e posterior, o nome padrão para um manifesto de recurso é usado quando ambas as seguintes condições são atendidas:

O arquivo de recurso não é explicitamente incluído no arquivo de projeto como um EmbeddedResource item com LogicalName, ManifestResourceNameou DependentUpon metadados.
A EmbeddedResourceUseDependentUponConvention propriedade não está definida como false no arquivo de projeto. Por padrão, essa propriedade é definida como true. Para obter mais informações, consulte EmbeddedResourceUseDependentUponConvention.

Se o arquivo de recurso for colocalizado com um arquivo de origem (.cs ou .vb) do mesmo nome de arquivo raiz, o nome completo do primeiro tipo definido no arquivo de origem será usado para o nome do arquivo de manifesto. Por exemplo, se MyNamespace.Form1 for o primeiro tipo definido em Form1.cs e Form1.cs estiver colocalizado com Form1.resx, o nome de manifesto gerado para esse arquivo de recurso será MyNamespace.Form1.resources.

Metadados LogicalName

Se um arquivo de recurso for explicitamente incluído no arquivo de projeto como um EmbeddedResource item com LogicalName metadados, o LogicalName valor será usado como o nome do manifesto. LogicalName tem precedência sobre quaisquer outros metadados ou configurações.

Por exemplo, o nome do manifesto para o arquivo de recurso definido no trecho de arquivo de projeto a seguir é SomeName.resources.

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

-ou-

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

Nota

Se LogicalName não for especificado, um EmbeddedResource com dois pontos (.) no nome do arquivo não funcionará, o que significa que GetManifestResourceNames não retorna esse arquivo.

O exemplo a seguir funciona corretamente:
```
<EmbeddedResource Include="X.resx" />
```
O exemplo a seguir não funciona:
```
<EmbeddedResource Include="X.fr-FR.resx" />
```

Metadados ManifestResourceName

Se um arquivo de recurso for explicitamente incluído no arquivo de projeto como um EmbeddedResource item com ManifestResourceName metadados (e LogicalName estiver ausente), o ManifestResourceName valor, combinado com a extensão de arquivo .resources, será usado como o nome do arquivo de manifesto.

Por exemplo, o nome do manifesto para o arquivo de recurso definido no trecho de arquivo de projeto a seguir é SomeName.resources.

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

O nome do manifesto para o arquivo de recurso definido no trecho de arquivo de projeto a seguir é SomeName.fr-FR.resources.

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

Metadados DependentUpon

Se um arquivo de recurso for explicitamente incluído no arquivo de projeto como um EmbeddedResource item com DependentUpon metadados (e LogicalNameManifestResourceName estiver ausente), as informações do arquivo de origem definido por DependentUpon serão usadas para o nome do arquivo de manifesto do recurso. Especificamente, o nome do primeiro tipo definido no arquivo de origem é usado no nome do manifesto da seguinte maneira: Namespace.Classname[. Cultura].recursos.

Por exemplo, o nome do manifesto para o arquivo de recurso definido no trecho de arquivo de projeto a seguir é Namespace.Classname.resources (onde Namespace.Classname é a primeira classe definida em MyTypes.cs).

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

O nome de manifesto para o arquivo de recurso definido no trecho de arquivo de projeto a seguir é Namespace.Classname.fr-FR.resources (onde Namespace.Classname é a primeira classe definida em MyTypes.cs).

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

Propriedade EmbeddedResourceUseDependentUponConvention

Se EmbeddedResourceUseDependentUponConvention estiver definido como false no arquivo de projeto, cada nome de arquivo de manifesto de recurso será baseado no namespace raiz do projeto e no caminho relativo da raiz do projeto para o arquivo .resx . Mais especificamente, o nome do arquivo de manifesto de recurso gerado é RootNamespace.RelativePathWithDotsForSlashes.[ Cultura.] recursos. Essa também é a lógica usada para gerar nomes de manifesto em versões do .NET Core anteriores à 3.0.