RegisterAssembly (Tarea)
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 Regasm.exe (Herramienta de registro de ensamblados).
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 no se registró 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 memoria caché global de ensamblados.No se debe especificar esta opción si se va a instalar posteriormente el ensamblado que se está registrando en la caché global de ensamblados. |
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. |
Comentarios
Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase TaskExtension, que hereda de la clase Task.Para obtener una lista de estos parámetros adicionales y sus descripciones, vea TaskExtension (Clase base).
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>