REGASM.EXE |
Outil d'enregistrement d'assemblage |
|---|---|
| .NET | |
Syntaxe
| regasm assemblyFile [options] |
Paramètres
| Paramètre | Description |
|---|---|
| assemblyFile | Ce paramètre permet d'indiquer l'assembly à enregistrer auprès de COM. |
| /? | Ce paramètre permet d'afficher la syntaxe de commande et les options de l'outil. |
| /asmpath:directory | Ce paramètre permet d'indiquer un répertoire contenant des références d'assembly. Doit être utilisé avec l'option /regfile. |
| /codebase | Ce paramètre permet de créer une entrée Codebase dans le registre. L'entrée Codebase spécifie le chemin d'accès au fichier pour un assembly n'étant pas installé dans le Global Assembly Cache. Ne spécifiez pas cette option si vous installez ultérieurement l'assembly que vous enregistrez dans le Global Assembly Cache. Il est fortement recommandé que le paramètre assemblyFile que vous spécifiez avec l'option /codebase soit un assembly avec nom fort. |
| /help | Ce paramètre permet d'afficher la syntaxe de commande et les options de l'outil. |
| /nologo | Ce paramètre permet de supprimer l'affichage de la bannière de démarrage de Microsoft. |
| /regfile[:regFile] | Ce paramètre permet de générer le fichier .reg spécifié pour l'assembly, contenant les entrées de registre nécessaires. La spécification de cette option ne modifie pas le registre. Vous ne pouvez pas utiliser cette option avec les options /u ou /tlb. |
| /registered | Ce paramètre permet d'indiquer que cet outil ne fera référence qu'aux bibliothèques de types ayant déjà été inscrites. |
| /s | Ce paramètre permet de supprimer l'affichage des messages de réussite. |
| /silent | Ce paramètre permet de supprimer l'affichage des messages de réussite. |
| /tlb[:typeLibFile] | Ce paramètre permet de générer une bibliothèque de types à partir de l'assembly spécifié contenant les définitions des types accessibles définis dans l'assembly. |
| /u | Ce paramètre permet d'annuler l'enregistrement des classes pouvant être créées trouvées dans assemblyFile. Si cette option est omise, Regasm.exe enregistre les classes pouvant être créées dans l'assembly. |
| /unregister | Ce paramètre permet d'annuler l'enregistrement des classes pouvant être créées trouvées dans assemblyFile. Si cette option est omise, Regasm.exe enregistre les classes pouvant être créées dans l'assembly. |
| /verbose | Ce paramètre permet d'indiquer le mode détaillé ; affiche une liste de tous les assemblys référencés pour lesquels une bibliothèque de types doit être générée, lorsqu'elle est spécifiée avec l'option /tlb. |
Description
Cette commande permet de lire les métadonnées dans un assembly et ajoute les entrées nécessaires au registre. Cela permet aux clients COM d'apparaître en tant que classes de cadre d'application .NET.
Remarques
- Les options de ligne de commande Regasm.exe ne sont pas sensibles à la casse. Il vous suffit de fournir suffisamment d'options pour l'identifier de manière unique. Par exemple, /n est équivalent à /nologo et /t:outfile.tlb est équivalent à /tlb:outfile.tlb.
- Vous pouvez utiliser l'option /regfile pour générer un fichier .reg contenant les entrées de registre au lieu d'apporter les modifications directement au registre. Vous pouvez mettre à jour le Registre sur un ordinateur en important le fichier .reg avec l'outil Registry Editor (Regedit.exe). Le fichier .reg ne contient aucune mise à jour du registre pouvant être effectuée par les fonctions de registre définies par l'utilisateur. L'option /regfile n'émet que des entrées de registre pour les classes gérées. Cette option n'émet pas d'entrées pour TypeLibID ou InterfaceID.
- Lorsque vous spécifiez l'option /tlb, Regasm.exe génère et enregistre une bibliothèque de types décrivant les types trouvés dans l'assembly. Regasm.exe place les bibliothèques de types générées dans le répertoire de travail actuel ou dans le répertoire spécifié pour le fichier de sortie. La génération d'une bibliothèque de types pour un assembly faisant référence à d'autres assemblys peut entraîner la génération simultanée de plusieurs bibliothèques de types. Vous pouvez utiliser la bibliothèque de types pour fournir des informations de type aux outils de développement tels que Visual Studio. N'utilisez pas l'option /tlb si l'assembly que vous enregistrez a été produit par l'importateur de bibliothèque de types (Tlbimp.exe). Vous ne pouvez pas exporter une bibliothèque de types à partir d'un assembly ayant été importé à partir d'une bibliothèque de types. L'utilisation de l'option /tlb a le même effet que l'utilisation de l'exportateur de bibliothèque de types (Tlbexp.exe) et de Regasm.exe, à l'exception que Tlbexp.exe n'enregistre pas la bibliothèque de types qu'il produit. Si vous utilisez l'option /tlb pour inscrire une bibliothèque de types, vous pouvez utiliser l'option /tlb avec l'option /unregister pour annuler l'inscription de la bibliothèque de types. L'utilisation simultanée des deux options désenregistrera la bibliothèque de types et les entrées d'interface, ce qui peut nettoyer considérablement le registre.
- Lorsque vous enregistrez un assembly pour une utilisation par COM, Regasm.exe ajoute des entrées au registre sur l'ordinateur local. Plus précisément, il crée des clefs de registre dépendantes de la version permettant à plusieurs versions du même assembly de s'exécuter côte à côte sur un ordinateur. La première fois qu'un assembly est enregistré, une clef de niveau supérieur est créée pour l'assembly et une sous-clef unique est créée pour la version spécifique. Chaque fois que vous enregistrez une nouvelle version de l'assembly, Regasm.exe crée une sous-clef pour la nouvelle version.
- Par exemple, considérez un scénario dans lequel vous enregistrez le composant géré, myComp.dll, version 1.0.0.0 pour une utilisation par COM. Plus tard, vous enregistrez myComp.dll, version 2.0.0.0. Vous déterminez que toutes les applications clientes COM sur l'ordinateur utilisent myComp.dll version 2.0.0.0 et vous décidez de désinscrire myComponent.dll version 1.0.0.0. Ce schéma de registre vous permet de désinscrire myComp.dll version 1.0.0.0 car seule la sous-clef de la version 1.0.0.0 est supprimée.
- Après avoir inscrit un assembly à l'aide de Regasm.exe, vous pouvez l'installer dans le Global Assembly Cache afin qu'il puisse être activé à partir de n'importe quel client COM. Si l'assembly ne doit être activé que par une seule application, vous pouvez le placer dans le répertoire de cette application. L'utilisation de l'option /codebase est une alternative à l'utilisation du Global Assembly Cache ; cependant, l'emplacement de l'assembly lors de l'enregistrement est enregistré globalement et l'activation échouera si l'assembly est déplacé. Si l'assembly n'est pas trouvé par sondage, l'option /codebase charge l'assembly dans un contexte de chargement à partir de ayant des considérations supplémentaires documentées dans Assembly.LoadFrom.
Exemple
L'exemple suivante enregistre toutes les classes publiques contenues dans monTest.dll :
| regasm monTest.dll |
Dernière mise à jour : Vendredi, le 25 Mars 2022