RegisterAssembly (tâche)RegisterAssembly task

Lit les métadonnées dans l’assembly spécifié et ajoute les entrées nécessaires au Registre, ce qui permet aux clients COM de créer des classes .NET Framework.NET Framework en toute transparence.Reads the metadata within the specified assembly and adds the necessary entries to the registry, which allows COM clients to create .NET Framework.NET Framework classes transparently. Le comportement de cette tâche est similaire, mais pas identique, à celui de Regasm.exe (outil d’inscription d’assemblys).The behavior of this task is similar, but not identical, to that of the Regasm.exe (Assembly Registration tool).

ParamètresParameters

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

ParamètreParameter DescriptionDescription
Assemblies Paramètre ITaskItem[] obligatoire.Required ITaskItem[] parameter.

Spécifie les assemblys à inscrire auprès de COM.Specifies the assemblies to be registered with COM.
AssemblyListFile Paramètre ITaskItem facultatif.Optional ITaskItem parameter.

Contient des informations sur 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 UnregisterAssembly ne peut donc pas tenter de désinscrire un assembly dont l’inscription dans la tâche RegisterAssembly a échoué.This information prevents the UnregisterAssembly task from attempting to unregister an assembly that failed to register in the RegisterAssembly task.
CreateCodeBase Paramètre Boolean facultatif.Optional Boolean parameter.

Si true, crée une entrée Codebase dans le Registre, qui spécifie le chemin de fichier d’un assembly qui n’est pas installé dans le Global Assembly Cache.If true, creates a codebase entry in the registry, which specifies the file path for an assembly that is not installed in the global assembly cache. Vous ne devez pas spécifier cette option si vous devez installer par la suite l'assembly que vous inscrivez dans le Global Assembly Cache.You should not specify this option if you will subsequently install the assembly that you are registering into the global assembly cache.
TypeLibFiles Paramètre de sortie ITaskItem[] facultatif.Optional ITaskItem[] output parameter.

Spécifie la bibliothèque de types à générer à partir de l’assembly spécifié.Specifies the type library to generate from the specified assembly. La bibliothèque de types générée contient des définitions des types accessibles définis dans l’assembly.The generated type library contains definitions of the accessible types defined within the assembly. La bibliothèque de types n’est générée que si l’une des conditions suivantes est remplie :The type library is only generated if one of the following conditions is true:

- Il n’existe pas de bibliothèque de types de ce nom à cet emplacement.- A type library of that name does not exist at that location.
- Il existe une bibliothèque de types, mais elle est plus ancienne que l’assembly passé.- A type library exists but it's older than the assembly being passed in.

Si la bibliothèque de types est plus récente que l’assembly passé, il n’en est pas créé de nouvelle, mais l’assembly est quand même inscrit.If the type library is newer than the assembly being passed, a new one won't be created, but the assembly will still be registered.

Si ce paramètre est spécifié, il doit avoir le même nombre d’éléments que le paramètre Assemblies, sinon la tâche échoue.If this parameter is specified, it must have the same number of items as the Assemblies parameter or the task will fail. Si aucune entrée n’est spécifiée, la tâche utilise par défaut le nom de l’assembly et remplace l’extension de l’élément par .tlb.If no inputs are specified, the task will default to the name of the assembly and change the extension of the item to .tlb.

NotesRemarks

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension, qui elle-même hérite de la classe Task.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base TaskExtension.For a list of these additional parameters and their descriptions, see TaskExtension base class.

ExempleExample

L’exemple suivant utilise la tâche RegisterAssembly pour inscrire l’assembly spécifié par la collection d’éléments MyAssemblies.The following example uses the RegisterAssembly task to register the assembly specified by the MyAssemblies item collection.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  

    <ItemGroup>  
        <MyAssemblies Include="MyAssembly.dll" />  
    <ItemGroup>  

    <Target Name="RegisterAssemblies">  
        <RegisterAssembly  
            Assemblies="@(MyAssemblies)" >  
    </Target>  

</Project>  

Voir aussiSee also

Tâches Tasks
Informations de référence sur les tâchesTask reference