UnregisterAssembly, tâcheUnregisterAssembly Task

Désinscrit les assemblys spécifiés dans le cadre de COM Interop.Unregisters the specified assemblies for COM interop purposes. Exécute l’opération inverse de la tâche RegisterAssembly.Performs the reverse of the RegisterAssembly task.

ParamètresParameters

Le tableau ci-dessous décrit les paramètres de la tâche UnregisterAssembly .The following table describes the parameters of the UnregisterAssembly task.

ParamètreParameter DescriptionDescription
Assemblies Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Spécifie les assemblys à désinscrire.Specifies the assemblies to be unregistered.
AssemblyListFile Paramètre ITaskItem facultatif.Optional ITaskItem parameter.

Contient des informations relatives à l’état entre la tâche RegisterAssembly et la tâche UnregisterAssembly.Contains information about the state between the RegisterAssembly task and the UnregisterAssembly task. La tâche ne peut donc pas tenter de désinscrire un assembly dont l’inscription dans la tâche RegisterAssembly a échoué.This prevents the task from attempting to unregister an assembly that failed to register in the RegisterAssembly task.

Si ce paramètre est spécifié, les paramètres Assemblies et TypeLibFiles sont ignorés.If this parameter is specified, the Assemblies and TypeLibFiles parameters are ignored.
TypeLibFiles Paramètre de sortie ITaskItem[] facultatif.Optional ITaskItem[] output parameter.

Désinscrit la bibliothèque de types spécifiée de l’assembly indiqué.Unregisters the specified type library from the specified assembly. Remarque : Ce paramètre est nécessaire uniquement si le nom de fichier de la bibliothèque de types est différent de celui de l’assembly.Note: This parameter is only necessary if the type library file name is different than the assembly name.

NotesRemarks

L’assembly ne doit pas forcément exister pour que cette tâche s’exécute correctement.It is not required that the assembly exists for this task to be successful. Si vous tentez de désinscrire un assembly qui n’existe pas, la tâche réussit avec un avertissement.If you attempt to unregister an assembly that does not exist, the task will succeed with a warning. En effet, la tâche a pour but de supprimer l’inscription de l’assembly du Registre.This occurs because it is the job of this task to remove the assembly registration from the registry. Si l’assembly n’existe pas, il n’est pas dans le Registre, et par conséquent, la tâche réussit.If the assembly does not exist, it is not in the registry, and therefore, the task succeeded.

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe AppDomainIsolatedTaskExtension, qui elle-même hérite de la classe MarshalByRefObject.In addition to the parameters listed above, this task inherits parameters from the AppDomainIsolatedTaskExtension class, which itself inherits from the MarshalByRefObject class. La classe MarshalByRefObject fournit la même fonctionnalité que la classe Task, mais peut être instanciée dans son propre domaine d’application.The MarshalByRefObject class provides the same functionality as the Task class, but it can be instantiated in its own application domain.

ExempleExample

L’exemple suivant utilise la tâche UnregisterAssembly pour désinscrire l’assembly dans le chemin spécifié par les propriétés OutputPath et FileName, s’il existe.The following example uses the UnregisterAssembly task to unregister the assembly at the path specified by the OutputPath and FileName properties, if it exists.

<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>  

Voir aussiSee Also

RegisterAssembly, tâche RegisterAssembly Task
Tâches MSBuild Tasks
Task Reference (Informations de référence sur les tâches MSBuild)Task Reference