Tarefa de ResolveComReference

Leva a uma lista de um ou mais nomes de biblioteca de tipos ou arquivos. tlb e resolve essas bibliotecas de tipo para locais no disco.

Parâmetros

A tabela a seguir descreve os parâmetros da ResolveCOMReference de tarefas.

Parâmetro	Descrição
DelaySign	Opcional Boolean parâmetro. Se true, coloca a chave pública do assembly. Se false, totalmente assina o assembly.
EnvironmentVariables	Opcional String[] parâmetro. Matriz de pares de variáveis de ambiente, separadas por sinais de igual. Essas variáveis são passadas para o Tlbimp. exe gerado e o aximp. exe além ou bloquear seletivamente substituindo, de ambiente regular..
ExecuteAsTool	Opcional Boolean parâmetro. Se true, que executa o Tlbimp. exe e aximp. exe a partir do destino apropriado framework fora do processo para gerar assemblies de invólucro necessários. Este parâmetro habilita o multi-direcionamento.
IncludeVersionInInteropName	Opcional Boolean parâmetro. Se true, a versão de typelib será incluída no nome de wrapper. O padrão é false.
KeyContainer	Opcional String parâmetro. Especifica um contêiner que mantém uma pública/particular par de chaves.
KeyFile	Opcional String parâmetro. Especifica um item que contém uma pública/particular par de chaves.
NoClassMembers	Opcional Boolean parâmetro.
ResolvedAssemblyReferences	Opcional ITaskItem[] parâmetro de saída. Especifica as referências de assembly resolvida.
ResolvedFiles	Opcional ITaskItem[] parâmetro de saída. Especifica os arquivos totalmente qualificados no disco que correspondem aos locais físicos das bibliotecas de tipos que foram fornecidos como entrada para esta tarefa.
ResolvedModules	Opcional ITaskItem[] parâmetro.
SdkToolsPath	Opcional [String] parâmetro. Se ExecuteAsTool é true, esse parâmetro deve ser definido para o caminho de ferramentas do SDK para a versão do framework visado.
StateFile	Opcional [String] parâmetro. Especifica o arquivo de cache COM carimbos de hora de componente. Se não estiver presente, a cada execução será regenerar todos os wrappers.
TargetFrameworkVersion	Opcional [String] parâmetro. Especifica a versão de framework de destino do projeto. O padrão é String.Empty. o que significa não há nenhuma filtragem para uma referência com base na estrutura de destino.
TargetProcessorArchitecture	Opcional [String] parâmetro. Especifica a arquitetura de processador de destino preferido. Passado o sinalizador de /machine Tlbimp. exe após a tradução. O valor do parâmetro deve ser um membro do ProcessorArchitecture.
TypeLibFiles	Opcional ITaskItem[] parâmetro. Especifica o caminho do arquivo de biblioteca tipo COM referências. Itens incluídos neste parâmetro podem conter metadados de item. Para obter mais informações, consulte a seção "Metadados de Item TypeLibFiles" abaixo.
TypeLibNames	Opcional ITaskItem[] parâmetro. Especifica os nomes da biblioteca de tipos para resolver. Itens incluídos neste parâmetro devem conter alguns metadados do item. Para obter mais informações, consulte a seção "Metadados de Item de TypeLibNames" abaixo.
WrapperOutputDirectory	Opcional String parâmetro. O local no disco onde o assembly de interoperabilidade gerado será colocado. Se este item de metadados não for especificado, a tarefa usa o caminho absoluto do diretório onde se encontra o arquivo de projeto.

Comentários

Direcionamento de componentes de 32 bits em computadores de 64 bits

Em uma máquina de 64 bits, Framework64 / <version> / msbuild não é possível resolver a objetos registrados como componentes de 32 bits. Por exemplo, se você registrar um COM objeto com o regsvr32 e tente criar um projeto de direcionamento a plataforma x86 com Framework64 / <version> / msbuild, a compilação é incapaz de resolver o objeto COM. Se em vez disso você construir com estrutura / <version> / msbuild, a compilação é capaz de resolver o objeto COM.

Metadados de Item de TypeLibNames

A tabela a seguir descreve os metadados de item disponível para itens passaram para o TypeLibNames parâmetro.

Metadados	Descrição
GUID	Metadados de item obrigatório. O GUID para a biblioteca de tipos. Se este item de metadados não for especificado, a tarefa falhar.
VersionMajor	Metadados de item obrigatório. A versão principal da biblioteca de tipos. Se este item de metadados não for especificado, a tarefa falhar.
VersionMinor	Metadados de item obrigatório. A versão secundária da biblioteca de tipos. Se este item de metadados não for especificado, a tarefa falhar.
LocaleIdentifier	Metadados de item opcional. O identificador de localidade (ou LCID) para a biblioteca de tipos. Isso é especificado como um valor de 32 bits que identifica o idioma humano preferido por um usuário, a região ou o aplicativo. Se este item de metadados não for especificado, a tarefa usa um identificador de localidade padrão de "0".
WrapperTool	Metadados de item opcional. Especifica a ferramenta wrapper que é usada para gerar o wrapper do assembly para a biblioteca de tipos. Se este item de metadados não for especificado, a tarefa usa uma ferramenta do wrapper padrão de "tlbimp". As opções disponíveis, entre maiúsculas e minúsculas de typelibs são: Primary: Use essa ferramenta wrapper quando desejar usar um assembly de interoperabilidade primário já gerado para o componente COM. Ao usar essa ferramenta wrapper, não especifique um diretório de saída de wrapper porque isso fará com que a tarefa falhe. TLBImp: Use essa ferramenta wrapper quando você deseja gerar um assembly de interoperabilidade para o componente COM. AXImp: Use essa ferramenta wrapper quando você deseja gerar um assembly de interoperabilidade para um componente de ActiveX.

Metadados de Item de TypeLibFiles

A tabela a seguir descreve os metadados de item disponível para itens passaram para o TypeLibFiles parâmetro.

Metadados

Descrição

WrapperTool

Metadados de item opcional. Especifica a ferramenta wrapper que é usada para gerar o wrapper do assembly para a biblioteca de tipos. Se este item de metadados não for especificado, a tarefa usa uma ferramenta do wrapper padrão de "tlbimp". As opções disponíveis, entre maiúsculas e minúsculas de typelibs são: Primary: Use essa ferramenta wrapper quando desejar usar um assembly de interoperabilidade primário já gerado para o componente COM. Ao usar essa ferramenta wrapper, não especifique um diretório de saída de wrapper porque isso fará com que a tarefa falhe. TLBImp: Use essa ferramenta wrapper quando você deseja gerar um assembly de interoperabilidade para o componente COM. AXImp: Use essa ferramenta wrapper quando você deseja gerar um assembly de interoperabilidade para um componente de ActiveX.

Observação

Mais informações você fornecer para identificar com exclusividade uma biblioteca de tipos, maior a possibilidade de que a tarefa será resolvido para o arquivo correto no disco.

Comentários

Além de para os parâmetros listados acima, esta tarefa herda parâmetros a partir de Task classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base da tarefa.

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild