Partilhar via


Tarefa AtribuirCultura

Esta tarefa aceita uma lista de itens que podem conter uma cadeia de caracteres de identificador de cultura .NET válida como parte do nome do arquivo e produz itens que têm um metadado chamado Culture contendo o identificador de cultura correspondente. Por exemplo, o nome do arquivo Form1.fr-fr .resx tem um identificador de cultura incorporado "fr-fr", portanto, essa tarefa produz um item que tem o mesmo nome de arquivo com os metadados Culture igual a fr-fr. A tarefa também produz uma lista de nomes de arquivos com a cultura removida do nome do arquivo.

Parâmetros da tarefa

A tabela a seguir descreve os parâmetros da tarefa AssignCulture.

Parâmetro Descrição
AssignedFiles Parâmetro de saída ITaskItem[] opcional.

Contém a lista de itens recebidos no parâmetro Files, com uma entrada de metadados Culture adicionada a cada item.

Se o item de entrada do parâmetro Files já contiver uma entrada de metadados Culture, a entrada de metadados original será usada.

A tarefa só atribui uma entrada de metadados Culture se o nome do arquivo contiver um identificador de cultura válido. O identificador de cultura deve estar entre os dois últimos pontos no nome do arquivo.
AssignedFilesWithCulture Parâmetro de saída ITaskItem[] opcional.

Contém o subconjunto dos itens do parâmetro AssignedFiles que têm uma entrada de metadados Culture.
AssignedFilesWithNoCulture Parâmetro de saída ITaskItem[] opcional.

Contém o subconjunto dos itens do parâmetro AssignedFiles que não têm uma entrada de metadados Culture.
CultureNeutralAssignedFiles Parâmetro de saída ITaskItem[] opcional.

Contém a mesma lista de itens que é produzida no parâmetro AssignedFiles, exceto com a cultura removida do nome do arquivo.

A tarefa só remove a cultura do nome do arquivo se for um identificador de cultura válido.
Files Parâmetro de ITaskItem[] necessário.

Especifica a lista de arquivos com nomes de cultura incorporados aos quais atribuir uma cultura. A tarefa tenta descobrir se cada arquivo é um recurso específico da cultura e, em caso afirmativo, qual cultura. Para ignorar esse processo de deteção e forçar um arquivo a ser neutro em termos de cultura, defina a entrada de metadados WithCulture como false.
RespectAlreadyAssignedItemCulture Parâmetro bool opcional.

Se definido como true - os metadados Culture já definidos no parâmetro Files item são respeitados e o CultureNeutralAssignedFiles será preenchido com nome de arquivo inalterado de Files.

Comentários

Além dos parâmetros listados neste artigo, essa tarefa herda parâmetros da classe TaskExtension, que herda da classe Task. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte classe base TaskExtension.

Exemplo

O exemplo a seguir executa a tarefa AssignCulture com a coleção ResourceFiles item.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <ResourceFiles Include="MyResource1.fr.resx"/>
        <ResourceFiles Include="MyResource2.XX.resx"/>
    </ItemGroup>

    <Target Name="Culture">
        <AssignCulture
            Files="@(ResourceFiles)"
            <Output TaskParameter="AssignedFiles"
                ItemName="OutAssignedFiles"/>
            <Output TaskParameter="AssignedFilesWithCulture"
                ItemName="OutAssignedFilesWithCulture"/>
            <Output TaskParameter="AssignedFilesWithNoCulture"
                ItemName="OutAssignedFilesWithNoCulture"/>
            <Output TaskParameter="CultureNeutralAssignedFiles"
                ItemName="OutCultureNeutralAssignedFiles"/>
        </AssignCulture>
    </Target>
</Project>

A tabela a seguir descreve o valor dos itens de saída após a execução da tarefa. Os metadados do item são mostrados entre parênteses após o item.

Coleção de itens Índice
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (sem metadados adicionais)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (sem metadados adicionais)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

MyResource2.XX.resx (sem metadados adicionais)

Ver também