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:
|
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:
|
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.