Compartir a través de


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:

  • Una biblioteca de tipos de dicho nombre no existe en esa ubicación.

  • Una biblioteca de tipos existe pero es anterior al ensamblado que se está pasando.

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>

Vea también

Conceptos

Tareas de MSBuild

Otros recursos

Referencia de tareas de MSBuild