RegisterAssembly (Tarea)
Actualización: noviembre 2007
Lee los metadatos del ensamblado especificado y agrega las entradas necesarias al Registro, lo que permite a los clientes COM crear clases de .NET Framework de forma transparente. El comportamiento de esta tarea es similar, pero no idéntico, al de Herramienta Registro de ensamblados (Regasm.exe).
Parámetros
En la siguiente tabla se describen los parámetros de la tarea RegisterAssembly.
Parámetro |
Descripción |
|---|---|
Assemblies |
Parámetro ITaskItem[] requerido. Especifica los ensamblados que se van a registrar con COM. |
AssemblyListFile |
Parámetro ITaskItem opcional. Contiene información sobre el estado entre las tareas RegisterAssembly y UnregisterAssembly. De esta forma, se evita que la tarea UnregisterAssembly trate de anular el registro de un ensamblado que provocó un error de registro en la tarea RegisterAssembly. |
CreateCodeBase |
Parámetro Boolean opcional. Si es true, crea una entrada de código base en el Registro, que especifica la ruta de acceso al archivo de un ensamblado que no está instalado en la caché global del ensamblado. No se debe especificar esta opción si se va a instalar posteriormente el ensamblado que se está registrando en la caché de ensamblados global. |
TypeLibFiles |
Parámetro de salida ITaskItem[] opcional. Especifica la biblioteca de tipos que se generará a partir del ensamblado especificado. La biblioteca de tipos generada contiene las definiciones de los tipos accesibles definidas dentro del ensamblado. Sólo se genera la biblioteca de tipos si se cumple una de las condiciones siguientes:
Si la biblioteca de tipos es más reciente que el ensamblado que se está pasando, no se creará un nuevo ensamblado, aunque se podrá registrar. Si se especifica este parámetro, debe tener el mismo número de elementos que el parámetro Assemblies o en la tarea se producirá un error. Si no se especifica ninguna entrada, la tarea tendrá como valor predefinido el nombre del ensamblado y cambiará la extensión del elemento a .tlb. |
Ejemplo
En el siguiente ejemplo se utiliza la tarea RegisterAssembly para generar el ensamblado especificado por la colección de elementos MyAssemblies.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MyAssemblies Include="MyAssembly.dll" />
<ItemGroup>
<Target Name="RegisterAssemblies">
<RegisterAssembly
Assemblies="@(MyAssemblies)" >
</Target>
</Project>