ResolveComReference task

Toma una lista de uno o varios nombres de biblioteca de tipos o archivos .tlb y resuelve esas bibliotecas de tipos en ubicaciones del disco.

Parameters

En la tabla siguiente se describen los parámetros de la tarea ResolveCOMReference.

Parameter	Description
`DelaySign`	Parámetro de `Boolean` opcional. Si `true`es , coloca la clave pública en el ensamblado. Si `false`es , firma completamente el ensamblado.
`EnvironmentVariables`	Parámetro de `String[]` opcional. Matriz de pares de variables de entorno, separadas por signos iguales. Estas variables se pasan al tlbimp.exe generado y aximp.exe además de, o invalidar de forma selectiva, el bloque de entorno normal.
`ExecuteAsTool`	Parámetro de `Boolean` opcional. Si `true`, ejecuta tlbimp.exe y aximp.exe desde la plataforma de destino adecuada fuera de proceso para generar los ensamblados de contenedor necesarios. Este parámetro habilita la compatibilidad con múltiples versiones.
`IncludeVersionInInteropName`	Parámetro de `Boolean` opcional. Si `true`es , la versión de la biblioteca de tipos se incluye en el nombre del contenedor. El valor predeterminado es `false`.
`KeyContainer`	Parámetro de `String` opcional. Especifica un contenedor que contiene un par de claves pública o privada.
`KeyFile`	Parámetro de `String` opcional. Especifica un elemento que contiene un par de claves pública o privada.
`NoClassMembers`	Parámetro de `Boolean` opcional.
`ResolvedAssemblyReferences`	Parámetro de salida opcional ITaskItem`[]`. Especifica las referencias de ensamblado resueltas.
`ResolvedFiles`	Parámetro de salida opcional ITaskItem`[]`. Especifica los archivos completos en el disco que corresponden a las ubicaciones físicas de las bibliotecas de tipos que se proporcionaron como entrada para esta tarea.
`ResolvedModules`	Parámetro opcional ITaskItem`[]`.
`SdkToolsPath`	Parámetro de System.String opcional. Si `ExecuteAsTool` es `true`, este parámetro debe establecerse en la ruta de acceso de las herramientas del SDK para la versión del marco de destino.
`StateFile`	Parámetro de `String` opcional. Especifica el archivo de caché para las marcas de tiempo del componente COM. Si no está presente, cada ejecución vuelve a generar todos los contenedores.
`TargetFrameworkVersion`	Parámetro de `String` opcional. Especifica la versión del marco de destino del proyecto. El valor predeterminado es `String.Empty`. lo que significa que no hay ningún filtrado para una referencia basada en el marco de destino.
`TargetProcessorArchitecture`	Parámetro de `String` opcional. Especifica la arquitectura de procesador de destino preferida. Se pasa a la marca /machine detlbimp.exedespués de la traducción. El valor del parámetro debe ser miembro de ProcessorArchitecture.
`TypeLibFiles`	Parámetro opcional ITaskItem`[]`. Especifica la ruta de acceso del archivo de biblioteca de tipos a las referencias COM. Los elementos incluidos en este parámetro pueden contener metadatos de elementos. Para obtener más información, vea la sección TypeLibFiles item metadata (Metadatos del elemento TypeLibFiles).
`TypeLibNames`	Parámetro opcional ITaskItem`[]`. Especifica los nombres de la biblioteca de tipos que se van a resolver. Los elementos incluidos en este parámetro deben contener algunos metadatos de elementos. Para obtener más información, vea la sección TypeLibNames item metadata (Metadatos del elemento TypeLibNames).
`WrapperOutputDirectory`	Parámetro de `String` opcional. Ubicación en el disco donde se coloca el ensamblado de interoperabilidad generado. Si no se especifican los metadatos de este elemento, la tarea usa la ruta de acceso absoluta del directorio donde se encuentra el archivo del proyecto.

Metadatos del elemento TypeLibNames

En la tabla siguiente se describen los metadatos del elemento disponibles para los elementos pasados al TypeLibNames parámetro .

Metadata	Description
`GUID`	Metadatos de elemento necesarios. GUID de la biblioteca de tipos. Si no se especifican los metadatos de este 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 los metadatos de este 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 los metadatos de este elemento, se produce un error en la tarea.
`EmbedInteropTypes`	Metadatos opcionales `Boolean` . Si `true`es , inserte los tipos de interoperabilidad de esta referencia directamente en el ensamblado en lugar de generar un archivo DLL de interoperabilidad.
`LocaleIdentifier`	Metadatos de elementos opcionales. Identificador de configuración regional (o LCID) de la biblioteca de tipos. Este identificador se especifica como un valor de 32 bits que identifica el idioma humano preferido por un usuario, región o aplicación. Si no se especifican los metadatos de este elemento, la tarea usa un identificador de configuración regional predeterminado de "0".
`WrapperTool`	Metadatos de elementos opcionales. Especifica la herramienta contenedora que se usa para generar el contenedor de ensamblados para esta biblioteca de tipos. Si no se especifican los metadatos de este elemento, la tarea usa una herramienta contenedora predeterminada de "tlbimp". Las opciones disponibles sin distinción entre mayúsculas y minúsculas de las bibliotecas de tipos son: - `Primary`: use esta herramienta contenedora cuando desee usar un ensamblado de interoperabilidad primario ya generado para el componente COM. Al usar esta herramienta contenedora, no especifique un directorio de salida del contenedor porque esto hace que se produzca un error en la tarea. - `TLBImp`: use esta herramienta contenedora cuando desee generar un ensamblado de interoperabilidad para el componente COM. - `PrimaryOrTLBImp`: use esta herramienta contenedora cuando no esté seguro de si `Primary` o `TLBImp` es adecuado. La `Primary` lógica se aplica primero y, a continuación `TLBImp`, . - `AXImp`: use esta herramienta contenedora cuando desee generar un ensamblado de interoperabilidad para un control ActiveX.

Metadatos del elemento TypeLibFiles

En la tabla siguiente se describen los metadatos del elemento disponibles para los elementos pasados al TypeLibFiles parámetro .

Metadata Description

EmbedInteropTypes Parámetro de Boolean opcional.

Si truees , inserte los tipos de interoperabilidad de esta referencia directamente en el ensamblado en lugar de generar un archivo DLL de interoperabilidad.

WrapperTool Metadatos de elementos opcionales.

Especifica la herramienta contenedora que se usa para generar el contenedor de ensamblados para esta biblioteca de tipos. Si no se especifican los metadatos de este elemento, la tarea usa una herramienta contenedora predeterminada de "tlbimp". Las opciones disponibles sin distinción entre mayúsculas y minúsculas de las bibliotecas de tipos son:

- Primary: use esta herramienta contenedora cuando desee usar un ensamblado de interoperabilidad primario ya generado para el componente COM. Al usar esta herramienta contenedora, no especifique un directorio de salida del contenedor porque esto hace que se produzca un error en la tarea.
- TLBImp: use esta herramienta contenedora cuando desee generar un ensamblado de interoperabilidad para el componente COM.
- AXImp: use esta herramienta contenedora cuando desee generar un ensamblado de interoperabilidad para un control ActiveX.

Metadata	Description
`EmbedInteropTypes`	Parámetro de `Boolean` opcional. Si `true`es , inserte los tipos de interoperabilidad de esta referencia directamente en el ensamblado en lugar de generar un archivo DLL de interoperabilidad.
`WrapperTool`	Metadatos de elementos opcionales. Especifica la herramienta contenedora que se usa para generar el contenedor de ensamblados para esta biblioteca de tipos. Si no se especifican los metadatos de este elemento, la tarea usa una herramienta contenedora predeterminada de "tlbimp". Las opciones disponibles sin distinción entre mayúsculas y minúsculas de las bibliotecas de tipos son: - `Primary`: use esta herramienta contenedora cuando desee usar un ensamblado de interoperabilidad primario ya generado para el componente COM. Al usar esta herramienta contenedora, no especifique un directorio de salida del contenedor porque esto hace que se produzca un error en la tarea. - `TLBImp`: use esta herramienta contenedora cuando desee generar un ensamblado de interoperabilidad para el componente COM. - `AXImp`: use esta herramienta contenedora cuando desee generar un ensamblado de interoperabilidad para un control ActiveX.

Note

Cuanto más información proporcione para identificar de forma única una biblioteca de tipos, mayor será la posibilidad de que la tarea se resuelva en el archivo correcto en el disco.

Remarks

Además de los parámetros enumerados en este artículo, esta tarea hereda los parámetros de la Task clase . Para obtener una lista de estos parámetros adicionales y sus descripciones, vea clase base task.

No es necesario registrar el archivo DLL COM en la máquina para que esta tarea funcione.

MSB4803 Error

Si intenta ejecutar un proyecto que usa la ResolveCOMReference tarea desde los comandos de la dotnet CLI, obtendrá el error:

MSB4803: The task "ResolveComReference" is not supported on the .NET Core version of MSBuild. Please use the .NET Framework version of MSBuild.

Esta tarea no se admite en la versión de .NET Core de MSBuild, que es lo que se usa al ejecutar el dotnet build comando desde la línea de comandos. Intente compilar el proyecto invocando MSBuild.exe desde el símbolo del sistema para desarrolladores de Visual Studio, ya que este ejecutable usa la versión de .NET Framework de MSBuild.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-08-08