タイプ ライブラリ エクスポータ (Tlbexp.exe)

タイプ ライブラリ エクスポータは、共通言語ランタイム アセンブリで定義されている型を記述するタイプ ライブラリを生成します。

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

パラメータ

メモ :
Tlbexp.exe のコマンド ライン オプションでは、大文字と小文字が区別されません。また、これらのオプションは任意の順序で指定できます。オプションを一意に識別するために十分である場合は、オプションの一部を指定するだけでもかまいません。たとえば、/n を指定した場合は /nologo、/o:outfile.tlb と指定した場合は /out:outfile.tlb であると見なされます。

解説

Tlbexp.exe は、アセンブリで定義されている型の定義を含む、タイプ ライブラリを生成します。Visual Basic 6.0 などのアプリケーションは、このツールで生成されたタイプ ライブラリを使用して、アセンブリ内で定義されている .NET 型にバインドできます。

アセンブリ全体が一度に変換されます。Tlbexp.exe を使用しても、アセンブリで定義されている型のサブセットに関する型情報は生成できません。

Tlbexp.exe を使用して、タイプ ライブラリ インポータ (Tlbimp.exe) でインポートしたアセンブリからタイプ ライブラリを生成することもできません。代わりに、Tlbimp.exe でインポートした元のタイプ ライブラリを参照する必要があります。しかし、Tlbimp.exe でインポートしたアセンブリを参照するアセンブリから、タイプ ライブラリをエクスポートすることはできます。後述の例を参照してください。

Tlbexp.exe は、生成したタイプ ライブラリを現在のディレクトリ、または出力ファイルとして指定したディレクトリに格納します。単一のアセンブリから複数のタイプ ライブラリが生成されることもあります。

Tlbexp.exe はタイプ ライブラリを生成しますが、生成したタイプ ライブラリの登録は行いません。これは、タイプ ライブラリの生成と登録を両方とも行うアセンブリ登録ツール (Regasm.exe) とは対照的です。タイプ ライブラリを生成して COM に登録するには、Regasm.exe を使用します。

/win32 オプションまたは /win64 オプションを指定しないと、Tlbexp.exe はコンパイルを実行するコンピュータのタイプ (32 ビット コンピュータまたは 64 ビット コンピュータ) に応じて、32 ビットまたは 64 ビットのタイプ ライブラリを生成します。クロス コンパイルを行う場合は、32 ビット コンピュータ上で /win64 オプションを使用して 64 ビットのタイプ ライブラリを生成したり、64 ビット コンピュータ上で /win32 オプションを使用して 32 ビットのタイプ ライブラリを生成したりできます。32 ビットのタイプ ライブラリでは、SYSKIND 値は SYS_WIN32 に設定されます。64 ビットのタイプ ライブラリでは、SYSKIND 値は SYS_WIN64 に設定されます。すべてのデータ型変換 (たとえば、IntPtr や UIntPtr などのポインタ-サイズ データ型) は、適切に変換されます。

MarshalAsAttribute 属性を使用して、VT_UNKOWN または VT_DISPATCH の SafeArraySubType 値を指定すると、Tlbexp.exe は後続で使用される SafeArrayUserDefinedSubType フィールドをすべて無視します。たとえば、次のようなシグネチャがあるとします。

[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;}

次のタイプ ライブラリが生成されます。

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

Tlbexp.exe は SafeArrayUserDefinedSubType フィールドを無視することに注意してください。

アセンブリ内にあるすべての情報をタイプ ライブラリに含めることはできないので、エクスポート プロセス中、Tlbexp.exe によって一部のデータが破棄される場合があります。変換処理、およびタイプ ライブラリに出力される各情報のソースの識別については、「アセンブリからタイプ ライブラリへの変換の要約」を参照してください。

タイプ ライブラリ エクスポータは、TypedReference オブジェクトがアンマネージ コードで意味を持たない場合でも、TypedReference パラメータが VARIANT であるメソッドをエクスポートします。タイプ ライブラリ エクスポータ (Tlbexp.exe)TypedReference パラメータを持つメソッドをエクスポートしても、タイプ ライブラリ エクスポータは警告やエラーを生成しません。作成されたタイプ ライブラリを使用するアンマネージ コードは、正しく動作しません。

タイプ ライブラリ エクスポータは、Microsoft Windows 2000 以降でサポートされます。

例

myTest.dll 内で見つかったアセンブリと同じ名前を持つタイプ ライブラリを生成するコマンドを次に示します。

tlbexp myTest.dll

clipper.tlb という名前を持つタイプ ライブラリを生成するコマンドを次に示します。

tlbexp myTest.dll /out:clipper.tlb

Tlbexp.exe を使用してインポートしたアセンブリを参照するアセンブリから、Tlbimp.exe を使用してタイプ ライブラリをエクスポートする例を次に示します。

まず、Tlbimp.exe を使用してタイプ ライブラリ myLib.tlb をインポートし、myLib.dll として保存します。

tlbimp myLib.tlb /out:myLib.dll

上記の例で作成した myLib.dll を参照する Sample.dll を C# コンパイラでコンパイルするコマンドを次に示します。

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

myLib.dll を参照する Sample.dll 用のタイプ ライブラリを生成するコマンドを次に示します。

tlbexp Sample.dll

参照

関連項目

TypeLibExporterFlags Enumeration
.NET Framework ツール
アセンブリ登録ツール (Regasm.exe)
タイプ ライブラリ インポータ (Tlbimp.exe)
SDK のコマンド プロンプト

その他の技術情報

アセンブリからタイプ ライブラリへの変換の要約