Tlbexp.exe (exportateur de bibliothèques de types)

L'outil Type Library Exporter (Exportateur de bibliothèques de types) génère une bibliothèque de types décrivant les types définis dans un assembly du Common Language Runtime.

Cet outil est installé automatiquement avec Visual Studio. Pour exécuter l’outil, utilisez l’invite de commandes développeur Visual Studio ou PowerShell pour développeurs Visual Studio.

À l'invite de commandes, tapez :

Syntaxe

tlbexp assemblyName [options]  

Paramètres

Notes

Tlbexp.exe génère une bibliothèque de types comportant les définitions des types définis dans l'assembly. Des applications, telles que Visual Basic 6.0, peuvent utiliser la bibliothèque de types générée pour créer une liaison vers les types .NET définis dans l'assembly.

La totalité de l'assembly est convertie immédiatement. Vous ne pouvez pas utiliser Tlbexp.exe pour générer des informations sur les types pour un sous-ensemble de types définis dans un assembly.

Vous ne pouvez pas utiliser Tlbexp.exe pour générer une bibliothèque de types à partir d’un assembly ayant été importé à l’aide de l’importateur de bibliothèques de types (Tlbimp.exe). À la place, vous devez faire référence à la bibliothèque de types d'origine importée avec Tlbimp.exe. Vous pouvez exporter une bibliothèque de types d'un assembly qui référence des assemblys importés à l'aide de Tlbimp.exe. Consultez la section des exemples ci-dessous.

Tlbexp.exe place les bibliothèques de types générées dans le répertoire de travail en cours ou dans le répertoire spécifié pour le fichier de sortie. Un seul assembly peut être à l'origine de plusieurs bibliothèques de types.

Tlbexp.exe génère une bibliothèque de types, mais ne l'inscrit pas. Par contre, l’outil d’inscription d’assembly (Regasm.exe) génère et inscrit une bibliothèque de types. Utilisez par conséquent Regasm.exe pour générer et inscrire une bibliothèque de types avec COM.

Si vous ne spécifiez pas l'option /win32 ou /win64, Tlbexp.exe génère une bibliothèque de types 32 bits ou 64 bits qui correspond au type d'ordinateur sur lequel vous exécutez la compilation (32 bits ou 64 bits). Pour les besoins de la compilation croisée, vous pouvez utiliser l'option /win64 sur un ordinateur 32 bits pour générer une bibliothèque de types 64 bits et l'option /win32 sur un ordinateur 64 bits pour générer une bibliothèque de types 32 bits. Dans les bibliothèques de types 32 bits, SYSKIND a la valeur SYS_WIN32. Dans les bibliothèques de types 64 bits, SYSKIND a la valeur SYS_WIN64. Toutes les transformations de type de données (par exemple, types de données classés selon la taille du pointeur comme IntPtr et UIntPtr) sont converties en conséquence.

Si vous utilisez l'attribut MarshalAsAttribute pour spécifier une valeur SafeArraySubType de VT_UNKNOWN ou VT_DISPATCH, Tlbexp.exe ignore toute utilisation subséquente du champ SafeArrayUserDefinedSubType. Examinons, par exemple, les signatures suivantes :

[return:MarshalAs(UnmanagedType.SafeArray, SafeArraySubType=VarEnum.VT_UNKNOWN, SafeArrayUserDefinedSubType=typeof(ConsoleKeyInfo))] public Array StructUnkSafe(){return null;}  
[return:MarshalAs(UnmanagedType.SafeArray, SafeArraySubType=VarEnum.VT_DISPATCH, SafeArrayUserDefinedSubType=typeof(ConsoleKeyInfo))] public Array StructDispSafe(){return null;}  

la bibliothèque de types suivante est générée :

[id(0x60020004)]  
HRESULT StructUnkSafe([out, retval] SAFEARRAY(IUnknown*)* pRetVal);  
[id(0x60020005)]  
HRESULT StructDispSafe([out, retval] SAFEARRAY(IDispatch*)* pRetVal);  

Notez que Tlbexp.exe ignore le champ SafeArrayUserDefinedSubType.

Comme les bibliothèques de types ne peuvent pas contenir toutes les informations figurant dans les assemblys, Tlbexp.exe peut ignorer certaines données au cours du processus d'exportation. Pour plus d’informations sur le processus de transformation et l’identification de la source de chaque information émise vers une bibliothèque de types, consultez Récapitulatif de la conversion d’un assembly en bibliothèque de types.

Notez que l'outil Type Library Exporter exporte des méthodes qui ont des paramètres TypedReference en tant que VARIANT, bien que l'objet TypedReference n'ait aucune signification dans le code non managé. Lorsque vous exportez des méthodes qui ont des paramètres TypedReference, l'outil Type Library Exporter ne générera aucun avertissement ni aucune erreur et le code non managé qui utilise la bibliothèque de types résultante ne s'exécutera pas correctement.

Exemples

La commande suivante génère une bibliothèque de types portant le même nom que celui de l'assembly figurant dans myTest.dll.

tlbexp myTest.dll  

La commande suivante génère une bibliothèque de types portant le nom clipper.tlb.

tlbexp myTest.dll /out:clipper.tlb  

L'exemple suivant illustre l'utilisation de Tlbexp.exe pour exporter une bibliothèque de types à partir d'un assembly faisant référence à des assemblys ayant été importés à l'aide de Tlbimp.exe.

Utilisez d'abord Tlbimp.exe pour importer la bibliothèque de types myLib.tlb et enregistrez-la sous myLib.dll.

tlbimp myLib.tlb /out:myLib.dll  

La commande suivante utilise le compilateur C# pour compiler les Sample.dllréférences créées myLib.dll dans l’exemple précédent.

CSC Sample.cs /reference:myLib.dll /out:Sample.dll  

La commande suivante génère une bibliothèque de types pour Sample.dll faisant référence à myLib.dll.

tlbexp Sample.dll  

Voir aussi

• TypeLibExporterFlags
• outils
• Regasm.exe (outil Assembly Registration Tool)
• Récapitulatif de la conversion d’un assembly en bibliothèque de types
• Tlbimp.exe (Type Library Importer)
• Interpréteurs de commandes de ligne de commande développeur