RegisterAssembly (tâche)
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 de façon transparente. Le comportement de cette tâche est similaire, mais pas identique, à celui de Regasm.exe (outil d’inscription d’assemblys).
Paramètres
Le tableau ci-dessous décrit les paramètres de la tâche RegisterAssembly
.
Paramètre | Description |
---|---|
Assemblies |
Paramètre ITaskItem[] obligatoire.Spécifie les assemblys à inscrire auprès de COM. |
AssemblyListFile |
Paramètre ITaskItem facultatif. Contient des informations sur l’état entre la tâche RegisterAssembly et la tâche UnregisterAssembly. La tâche UnregisterAssembly ne peut donc pas tenter de désinscrire un assembly dont l’inscription dans la tâche RegisterAssembly a échoué. |
CreateCodeBase |
Paramètre Boolean facultatif.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. 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. |
TypeLibFiles |
Paramètre de sortie ITaskItem[] facultatif.Spécifie la bibliothèque de types à générer à partir de l’assembly spécifié. La bibliothèque de types générée contient des définitions des types accessibles définis dans l’assembly. La bibliothèque de types n’est générée que si l’une des conditions suivantes est remplie : - Il n’existe aucune bibliothèque de types portant ce nom à cet emplacement. - Il existe une bibliothèque de types, mais elle est plus ancienne que l’assembly passé. 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. 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. 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. |
Remarques
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 . Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base TaskExtension.
Exemple
L’exemple suivant utilise la tâche RegisterAssembly
pour inscrire l’assembly spécifié par la collection d’éléments MyAssemblies
.
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MyAssemblies Include="MyAssembly.dll" />
<ItemGroup>
<Target Name="RegisterAssemblies">
<RegisterAssembly
Assemblies="@(MyAssemblies)" >
</Target>
</Project>
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour