Compartilhar via

Tarefa AssignCulture

  • Artigo

Essa 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 metadados nomeados Culture que contêm o identificador de cultura correspondente. Por exemplo, o nome do arquivo Form1.fr-fr.resx tem um identificador de cultura inserido "fr-fr", portanto, essa tarefa produz um item que tem o mesmo nome de arquivo com os metadados Culture iguais a fr-fr. A tarefa também produz uma lista de nomes de arquivo com a cultura removida do nome do arquivo.

Parâmetros de 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 atribuirá apenas 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 ponto 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 produzidos no parâmetro AssignedFiles, exceto com a cultura removida do nome do arquivo.

A tarefa só removerá 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 inseridos aos quais atribuir uma cultura. A tarefa tenta descobrir se cada arquivo é um recurso específico à cultura e, em caso afirmativo, qual cultura. Para ignorar esse processo de detecção e forçar um arquivo a ser neutro em termos de cultura, defina a entrada de metadados WithCulture como false.
RespectAlreadyAssignedItemCulture Parâmetro de bool opcional.

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

Observações

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 de classe base TaskExtension.

Exemplo

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

<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 de item são mostrados entre parênteses após o item.

Coleção de itens Conteúdo
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)

Consulte também

  • Tarefas
  • de referência da Tarefa