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 et avec le Kit de développement logiciel Windows. Pour exécuter l'outil, nous vous recommandons d'utiliser l'invite de commandes Visual Studio ou l'invite de commandes du Kit de développement logiciel (l'interpréteur de commandes CMD). Ces utilitaires vous permettent d'exécuter l'outil facilement, sans naviguer jusqu'au dossier d'installation. Pour plus d'informations, consultez Invites de commandes Visual Studio e t Kit de développement logiciel (SDK) Windows.

• Si Visual Studio est installé sur votre ordinateur : dans la barre des tâches, cliquez sur le bouton Start, All Programs, Visual Studio, sur Visual Studio Tools, puis sur Visual Studio Command Prompt.

  ou

  Si vous avez le Kit de développement logiciel Windows installé sur votre ordinateur : Dans la barre des tâches, cliquez sur Start, All Programs, le dossier correspondant au Kit de développement logiciel, puis sur Command Prompt (ou CMD Shell).

• À l'invite de commandes, tapez ce qui suit :

tlbexp assemblyName [/out:file] [/nologo] [/silent] [/verbose]

Paramètres

Remarque
Les options de ligne de commande de Tlbexp.exe ne respectent pas la casse et peuvent être spécifiées dans n'importe quel ordre.Il vous suffit de spécifier les éléments de l'option nécessaires à son identification de manière unique.Par exemple, /n équivaut à /nologo et /o:outfile.tlb à /out:outfile.tlb.

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 Type Library Importer (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 Assembly Registration Tool (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_UNKOWN 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ésumé 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.

L'outil Type Library Exporter est pris en charge sur Microsoft Windows 2000 et les versions ultérieures.

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 l'enregistrer sous myLib.dll.

tlbimp myLib.tlb /out:myLib.dll

La commande suivante utilise le compilateur C# pour compiler Sample.dll, faisant référence à myLib.dll créé au cours de 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

Référence

TypeLibExporterFlags

Regasm.exe (outil Assembly Registration Tool)

Tlbimp.exe (Type Library Importer)

Invites de commandes Visual Studio e t Kit de développement logiciel (SDK) Windows

Autres ressources

Outils du .NET Framework

Résumé de la conversion d'un assembly en bibliothèque de types

Historique des modifications