UnregisterAssembly (tarea)

  • Artículo

Elimina del Registro los ensamblados especificados para la interoperabilidad COM. Invierte la tarea RegisterAssembly.

Parámetros

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

Parámetro Descripción
Assemblies Parámetro ITaskItem[] opcional.

Especifica los ensamblados que se eliminarán del Registro.
AssemblyListFile Parámetro ITaskItem opcional.

Contiene información sobre el estado entre las tareas RegisterAssembly y UnregisterAssembly. Impide que la tarea intente eliminar del Registro un ensamblado que no se pudo registrar en la tarea RegisterAssembly.

Si se especifica este parámetro, se omiten los parámetros Assemblies y TypeLibFiles.
TypeLibFiles Parámetro de salida ITaskItem[] opcional.

Elimina del Registro la biblioteca de tipos especificada del ensamblado especificado. Nota: Este parámetro solo es necesario si el nombre de archivo de la biblioteca de tipos es diferente del nombre del ensamblado.

Comentarios

No es necesario disponer de un ensamblado para que esta tarea se realice correctamente. Si intenta eliminar del Registro un ensamblado que no existe, la tarea se realizará correctamente y se mostrará una advertencia. Esto se debe a que esta tarea se encarga de quitar el registro del ensamblado del Registro. Si el ensamblado no existe, no se encontrará en el Registro, por lo que la tarea ha conseguido su propósito.

Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase AppDomainIsolatedTaskExtension, que a su vez hereda de la clase MarshalByRefObject. La clase MarshalByRefObject proporciona la misma funcionalidad que la clase Task, pero se pueden crear instancias de esta clase en su propio dominio de aplicación.

Ejemplo

En el ejemplo siguiente se utiliza la tarea UnregisterAssembly para eliminar del Registro el ensamblado en la ruta de acceso especificada por las propiedades OutputPath y FileName, si existe.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <PropertyGroup>
        <OutputPath>\Output\</OutputPath>
        <FileName>MyFile.dll</FileName>
    </PropertyGroup>
    <Target Name="UnregisterAssemblies">
        <UnregisterAssembly
            Condition="Exists('$(OutputPath)$(FileName)')"
            Assemblies="$(OutputPath)$(FileName)" />
    </Target>

</Project>

Consulte también