ResolveComReference (Tarea)
Toma una lista de uno o más nombres de biblioteca de tipos o archivos .tlb y resuelve esas bibliotecas de tipos en ubicaciones de disco.
Parámetros
En la siguiente tabla se describen los parámetros de la tarea ResolveCOMReference.
Parámetro |
Descripción |
|---|---|
DelaySign |
Parámetro Boolean opcional. Si es true, se sitúa la clave pública en el ensamblado. Si es false, firma totalmente el ensamblado. |
EnvironmentVariables |
Parámetro String[] opcional. Matriz de pares de variables de entorno, separadas por signos igual. Estas variables se pasan a los archivos tlbimp.exe y aximp.exe generados además de, o invalidando selectivamente, el bloque de entorno regular. |
ExecuteAsTool |
Parámetro Boolean opcional. Si es true, se ejecutan tlbimp.exe y aximp.exe desde la versión de .NET Framework de destino adecuada fuera de proceso para generar los ensamblados de contenedor necesarios. Este parámetro permite la compatibilidad con múltiples versiones. |
IncludeVersionInInteropName |
Parámetro Boolean opcional. Si es true, la versión de la biblioteca de tipos será incluida en el nombre de contenedor. El tipo predeterminado es false. |
KeyContainer |
Parámetro String opcional. Especifica un contenedor que contiene una clave pública/privada par de claves. |
KeyFile |
Parámetro String opcional. Especifica un elemento que contiene una clave pública/privada par de claves. |
NoClassMembers |
Parámetro Boolean opcional. |
ResolvedAssemblyReferences |
Parámetro de salida ITaskItem[] opcional. Especifica las referencias de ensamblado resueltas. |
ResolvedFiles |
Parámetro de salida ITaskItem[] opcional. Especifica los nombres de archivo completos del disco asociados a las ubicaciones físicas de las bibliotecas de tipos que se proporcionaron como entrada para esta tarea. |
ResolvedModules |
Parámetro ITaskItem[] opcional. |
SdkToolsPath |
Parámetro [String] opcional. Si ExecuteAsTool es true, este parámetro debe establecerse como la ruta de acceso a las herramientas del SDK para la versión de .NET Framework de destino. |
StateFile |
Parámetro [String] opcional. Especifica el archivo caché de las marcas de tiempo de los componentes COM. Si no está presente, cada ejecución regenerará todos los contenedores. |
TargetFrameworkVersion |
Parámetro [String] opcional. Especifica la versión de .NET Framework de destino del proyecto. El tipo predeterminado es String.Empty. lo que significa que no hay filtrado para una referencia basada en la versión de .NET Framework de destino. |
TargetProcessorArchitecture |
Parámetro [String] opcional. Especifica la arquitectura preferida del procesador de destino. Pasado a la marca tlbimp.exe /equipo después de la traducción. El valor del parámetro debe ser un miembro de ProcessorArchitecture. |
TypeLibFiles |
Parámetro ITaskItem[] opcional. Especifica la ruta de acceso del archivo de biblioteca de tipos para las referencias COM. Los elementos incluidos en este parámetro pueden contener metadatos de elemento. Para obtener más información, vea más adelante la sección "Metadatos del elemento TypeLibFiles". |
TypeLibNames |
Parámetro ITaskItem[] opcional. Especifica los nombres de biblioteca de tipos que se deben resolver. Los elementos incluidos en este parámetro deben contener algunos metadatos de elemento. Para obtener más información, vea más adelante la sección "Metadatos del elemento TypeLibNames". |
WrapperOutputDirectory |
Parámetro String opcional. Ubicación en el disco donde se coloca el ensamblado de interoperabilidad generado. Si no se especifican estos metadatos de elemento, la tarea utiliza la ruta de acceso absoluta del directorio en el que está ubicado el archivo de proyecto. |
Comentarios
Destinar los componentes de 32 bits en equipos de 64 bits
En un equipo de 64 bits, Framework64/<versión>/msbuild no puede resolver una biblioteca de objetos COM registrada como componentes de 32 bits. Por ejemplo, si registra un objeto COM con regsvr32 y, a continuación, intenta compilar un proyecto destinado a la plataforma de x86 con Framework64/<versión>/msbuild, la compilación no puede resolver el objeto COM. Si en su lugar compila con Framework/<versión>/msbuild, la compilación puede resolver el objeto COM.
Metadatos del elemento TypeLibNames
En la tabla siguiente se describen los metadatos de elemento disponibles para los elementos pasados al parámetro TypeLibNames.
Metadatos |
Descripción |
|---|---|
GUID |
Metadatos de elemento necesarios. Identificador de interfaz (GUID) para la biblioteca de tipos. Si no se especifican estos metadatos de elemento, se produce un error en la tarea. |
VersionMajor |
Metadatos de elemento necesarios. La versión principal de la biblioteca de tipos. Si no se especifican estos metadatos de elemento, se produce un error en la tarea. |
VersionMinor |
Metadatos de elemento necesarios. La versión secundaria de la biblioteca de tipos. Si no se especifican estos metadatos de elemento, se produce un error en la tarea. |
LocaleIdentifier |
Metadatos de elemento opcionales. El identificador de configuración regional (o LCID) para la biblioteca de tipos. Se especifica como un valor de 32 bits que identifica el lenguaje humano preferido por un usuario, una región o una aplicación. Si no se especifican estos metadatos de elemento, la tarea utiliza un identificador de configuración regional predeterminado "0." |
WrapperTool |
Metadatos de elemento opcionales. Especifica la herramienta contenedor que se utiliza para generar el contenedor de ensamblado para esta biblioteca de tipos. Si no se especifican estos metadatos de elemento, la tarea utiliza una herramienta contenedor predeterminada "tlbimp". Las opciones disponibles de bibliotecas de tipos, sin distinción entre mayúsculas y minúsculas, son las siguientes:
|
Metadatos de elemento TypeLibFiles
En la tabla siguiente se describen los metadatos de elemento disponibles para los elementos pasados al parámetro TypeLibFiles.
Metadatos |
Descripción |
|---|---|
WrapperTool |
Metadatos de elemento opcionales. Especifica la herramienta contenedor que se utiliza para generar el contenedor de ensamblado para esta biblioteca de tipos. Si no se especifican estos metadatos de elemento, la tarea utiliza una herramienta contenedor predeterminada "tlbimp". Las opciones disponibles de bibliotecas de tipos, sin distinción entre mayúsculas y minúsculas, son las siguientes:
|
.gif "Nota") Nota |
|---|
Cuanta más información proporcione para identificar únicamente una biblioteca de tipos, mayores posibilidades habrá de que la tarea se resuelva en el archivo correcto del disco. |
Comentarios
Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase Task . Para obtener una lista de estos parámetros adicionales y sus descripciones, vea Task Base (Clase).