UnregisterAssembly, tâche

Annule l'inscription des assemblys spécifiés à des fins d'interopérabilité COM.Exécute l'opération inverse de la tâche RegisterAssembly.

Paramètres

Le tableau suivant décrit les paramètres de la tâche UnregisterAssembly.

Paramètre

Description

Assemblies

Paramètre ITaskItem[] optionnel.

Spécifie les assemblys dont il faut annuler l'inscription.

AssemblyListFile

Paramètre ITaskItem facultatif.

Contient des informations relatives à l'état entre la tâche RegisterAssembly et la tâche UnregisterAssembly.Cela empêche la tâche de tenter l'annulation de l'enregistrement d'un assembly qui n'a pas été enregistré dans la tâche RegisterAssembly.

Si ce paramètre est spécifié, les paramètres Assemblies et TypeLibFiles sont ignorés.

TypeLibFiles

Paramètre de sortie ITaskItem[] facultatif.

Annule l'inscription de la bibliothèque de types spécifiée dans l'assembly indiqué.

RemarqueRemarque
Ce paramètre est uniquement nécessaire si le nom de fichier de la bibliothèque de types est différent de celui de l'assembly.

Notes

L'assembly ne doit pas obligatoirement exister pour que cette tâche s'exécute correctement.Si vous tentez d'annuler l'inscription d'un assembly qui n'existe pas, la tâche réussit avec un avertissement.En effet, la tâche a pour but de supprimer l'inscription de l'assembly dans le Registre.Si l'assembly n'existe pas, il n'est pas dans le Registre, et par conséquent, la tâche réussit.

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe AppDomainIsolatedTaskExtension, qui hérite elle-même de la classe MarshalByRefObject.La classe MarshalByRefObject fournit les mêmes fonctionnalités que la classe Task, mais peut être instanciée dans son propre domaine d'application.

Exemple

L'exemple suivant utilise la tâche UnregisterAssembly pour annuler l'inscription de l'assembly dans le chemin d'accès spécifié par les propriétés OutputPath et FileName, s'il existe.

<Project xmlns="https://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>

Voir aussi

Référence

RegisterAssembly, tâche

Concepts

Tâches MSBuild

Autres ressources

Référence des tâches MSBuild