Tarefa GenerateResource

Converte entre .txt e .resx (baseado em XML recurso formato) arquivos e comum idioma runtime .recursos binário que pode ser incorporado em um executável binário de tempo de execução ou compilados em assemblies de satélite. Esta tarefa normalmente é usada para converter arquivos .txt ou .resx para arquivos .recurso. The GenerateResource tarefa é funcionalmente semelhante a Resgen.exe.

Parâmetros

A tabela a seguir descreve os parâmetros do GenerateResource tarefa.

Parâmetro	Descrição
FilesWritten	Opcional ITaskItem[] parâmetro de saída. Contém os nomes de todos os arquivos gravados em disco. Isso inclui o arquivo de cache, se houver. Este parâmetro é útil para implementações de limpar.
OutputResources	Opcional ITaskItem[] parâmetro de saída. Especifica o nome dos arquivos gerados sistema autônomo arquivos .Recursos. Se você não especificar um nome, o nome do arquivo de entrada correspondente é usado e o arquivo .Recursos criado é colocado no diretório que contém o arquivo de entrada.
PublicClass	Opcional Boolean parâmetro. If true, cria um fortemente tipados recurso classe sistema autônomo uma classe pública.
References	Opcional String[] parâmetro. Referências ao carregar tipos de arquivos .resx do. Elementos de dados do arquivo resx podem ter um tipo .NET. Quando o arquivo .resx é lido, isso deve ser resolvido. Normalmente, ele é resolvido-com êxito usando o tipo padrão de carregamento de regras. Se você fornecer assemblies em References, elas terão prioridade. Este parâmetro não é necessário para recursos fortemente tipados.
Sources	Necessário ITaskItem[] parâmetro. Especifica os itens para converter. Itens passadas para esse parâmetro devem ter uma das seguintes extensões de arquivo: .txt: Especifica a extensão para um arquivo de texto converter. Arquivos de texto só podem conter recursos de seqüência de caracteres. .resx: Especifica a extensão para um arquivo de recurso com base em XML converter. .restext: Especifica o mesmo formato, sistema autônomo .txt. Essa extensão diferente é útil se quiser distinguir claramente os arquivos de fonte que contêm recursos de outros arquivos de fonte no seu processo de compilação. .resources: Especifica a extensão para um arquivo de recurso converter.
StateFile	Opcional ITaskItem parâmetro. Especifica o caminho para um arquivo de cache opcional é usado para acelerar a verificação de links em arquivos de entrada de resx de dependência.
StronglyTypedClassName	Opcional String parâmetro. Especifica o nome de classe de tipo forte recurso classe. Se este parâmetro não for especificado, será usado o nome de base do arquivo de recurso.
StronglyTypedFilename	Opcional ITaskItem parâmetro. Especifica o nome de arquivo para o arquivo de fonte. Se este parâmetro não for especificado, o nome da classe é usado sistema autônomo o nome do arquivo base, com a extensão dependente de linguagem. Por exemplo: MyClass.cs.
StronglyTypedLanguage	Opcional String parâmetro. Especifica o linguagem a ser usada ao gerar a fonte de classe strongly typed Resources. Este parâmetro deve corresponder ao exatamente um dos idiomas usados pelo CodeDomProvider. Por exemplo: VB ou C#. Ao passar um valor para esse parâmetro, você instrui a tarefa para gerar recursos fortemente tipados.
StronglyTypedNamespace	Opcional String parâmetro. Especifica o namespace a ser usado para a fonte de classe gerada para o recurso com rigidez de tipos. Se este parâmetro não for especificado, todos os recursos com rigidez de tipos estão no namespace global.
UseSourcePath	Opcional Boolean parâmetro. If true, especifica que o diretório do arquivo de entrada deve ser usado para resolução de caminhos de arquivo relativo.

Comentários

Como arquivos .resx podem conter links para outros arquivos de recurso, não é suficiente simplesmente comparar timestamps arquivo .resx e .resource se as saídas são atualizadas. Em vez disso, a GenerateResource tarefa segue sistema autônomo links em arquivos .resx e verifica sistema autônomo carimbos de data/hora dos arquivos vinculados. Isso significa que você deve não geralmente usar Inputs e Outputs atributos no destino que contém o GenerateResource tarefas, pois isso pode causá-lo para ser ignoradas quando na verdade, ele deve ser executado.

Exemplo

O exemplo a seguir utiliza o GenerateResource tarefa para gerar arquivos .Recursos dos arquivos especificados pela Resx coleção de itens.

<GenerateResource
    Sources="@(Resx)"
    OutputResources="@(Resx->'$(IntermediateOutputPath)%(Identity).resources')">
    <Output
        TaskParameter="OutputResources"
        ItemName="Resources"/>
</GenerateResource>

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild