共用方式為


型別程式庫匯入工具 (TlbImp.exe)

型別程式庫匯入工具會將 COM 型別程式庫中的型別定義轉換為 Common Language Runtime 組件中的等效定義。Tlbimp.exe 的輸出是二進位檔案 (組件),它含有原來型別程式庫中所定義型別的執行階段中繼資料 (Metadata)。您可以使用像 ildasm.exe 這類的工具來檢查這個檔案。

tlbimp tlbFile [options]

參數

引數 說明

tlbFile

任何含有 COM 型別程式庫之檔案的名稱。

選項 說明

/asmversion: versionNumber

指定要產生之組件的版本號碼。以 major.minor.build.revision 格式來指定 versionNumber

/delaysign

指定由 Tlbimp.exe 以延遲簽署使用強式名稱,簽署產生的組件。您必須指定這個選項來配合 /keycontainer:/keyfile:/publickey: 選項。如需延遲簽署處理序的詳細資訊,請參閱延遲簽署組件

/help

顯示工具的命令語法和選項。

/keycontainer: containername

使用 containername 所指定之金鑰容器中的公開/私密金鑰組,以強式名稱進行簽署所產生的組件。

/keyfile: filename

使用 filename 中的發行者正式公開/私密金鑰組,以強式名稱進行簽署所產生的組件。

/namespace: namespace

指定要在其中產生組件的命名空間。

/noclassmembers

避免 Tlbimp.exe 將成員加入類別中。如此可避免可能發生的 TypeLoadException

/nologo

隱藏 Microsoft 程式啟始資訊顯示。

/out: filename

指定要將中繼資料定義寫入其中的輸出檔、組件及命名空間的名稱。如果型別程式庫指定了明確控制組件之命名空間的介面定義語言 (IDL) 自訂屬性 (Attribute),那麼 /out 選項對組件的命名空間就沒有作用。如果您不指定這個選項,Tlbimp.exe 會將中繼資料寫入到與輸入檔所定義之實際型別程式庫同樣名稱的檔案,並指派 .dll 副檔名給它。如果輸出檔與輸入檔同名,這個工具將會產生錯誤來防止覆寫型別程式庫。

/primary

對指定的型別程式庫產生主要 Interop 組件。指示產生這個組件之型別程式庫發行者的資訊會被加入到組件。藉由指定主要 Interop 組件,您就可以從使用 Tlbimp.exe 從型別程式庫建立的任何其他組件中區別發行者的組件。如果您是要以 Tlbimp.exe 匯入之型別程式庫的發行者,應該只使用 /primary 選項。請注意,您必須以強式名稱簽署主要 Interop 組件。如需詳細資訊,請參閱主要的 Interop 組件

/publickey: filename

指定含有要用來簽署所產生組件之公開金鑰的檔案。如果您指定 /keyfile:/keycontainer: 選項而不是 /publickey:,Tlbimp.exe 將會從 /keyfile:/keycontainer: 提供的公開/私密金鑰組產生公開金鑰。/publickey: 選項支援測試金鑰和延遲簽署的案例。這個檔案的格式是由 Sn.exe 產生。如需詳細資訊,請參閱強式名稱工具 (Sn.exe) 中 Sn.exe 的 -p 選項。

/reference: filename

指定要用來解析在目前型別程式庫之外所定義型別之參考的組件檔。如果您不指定 /reference 選項,Tlbimp.exe 會自動以遞迴方式匯入其型別程式庫正被匯入參考的任何外部型別程式庫。如果您指定了 /reference 選項,這個工具會在匯入其他型別程式庫之前,先嘗試解析被參考組件中的外部型別。

/silent

隱藏成功訊息的顯示。

/strictref

如果這個工具無法解析目前組件中、以 /reference 選項指定的組件中或是已登錄主要 Interop 組件 (PIA) 中的所有參考,就不要匯入型別程式庫。

/strictref:nopia

/strictref 相同,但是會忽略 PIA。

/sysarray

指定要由這個工具匯入 COM 樣式的 SafeArray 做為 Managed System.Array 類別型別。

/tlbreference: filename

指定用來解析型別程式庫參考的型別程式庫檔案,而不需要查閱登錄。

請注意,這個選項將不會載入某些較舊的型別程式庫格式。但是,您仍然可以透過登錄或目前的目錄,隱含載入較舊的型別程式庫格式。

/transform: transformName

transformName 參數所指定,轉換中繼資料。

transformName 參數指定 dispret,將分派介面 (Dispinterface) 上之方法的 [out, retval] 參數轉換為傳回值。

如需這個選項的詳細資訊,請參閱稍後在本主題中的範例。

/unsafe

產生不經 .NET Framework 安全性檢查的介面。呼叫以這種方式公開的方法可能會造成安全性的風險。除非您很清楚公開這種程式碼的風險,否則不應使用這個選項。

/verbose

指定詳細資訊模式;顯示匯入之型別程式庫的其他資訊。

/?

顯示工具的命令語法和選項。

Note注意事項

Tlbimp.exe 的命令列選項不區分大小寫,而且可以依任何順序提供。您只需要指定足夠的選項來唯一識別它。因此,/n 相當於 /nologo,且 /ou:outfile.dll 相當於 /out:outfile.dll

備註

Tlbimp.exe 會一次執行整個型別程式庫的轉換。您不能使用這個工具對單一型別程式庫中所定義之型別的子集產生型別資訊。

有時候會需要甚至必須能夠指派強式名稱給組件。因此,Tlbimp.exe 包含了提供產生以強式名稱命名之組件所需資訊的選項。/keyfile:/keycontainer: 這兩個選項都會以強式名稱簽署組件。所以,一次只提供一個這種選項是很合理的。

在從含有多個型別程式庫的模組匯入型別程式庫時,可以選擇性地將資源 ID 附加到型別程式庫檔案。只有在這個檔案是位於目前的目錄中,或者您指定了完整路徑時,Tlbimp.exe 才能夠找到這個檔案。請參閱本主題稍後的範例。

範例

下列命令會產生與 myTest.tlb 中所找到的型別程式庫同名且副檔名為 .dll 的組件。

tlbimp myTest.tlb 

下列命令會以 myTest.dll 名稱產生組件。

tlbimp  myTest.tlb  /out:myTest.dll

下列命令會產生與 MyModule.dll\1 所指定的型別程式庫同名且副檔名為 .dll 的組件。MyModule.dll\1 必須位於目前的目錄中。

tlbimp MyModule.dll\1

下列命令會針對 TestLib.dll 型別程式庫產生名稱為 myTestLib.dll 的組件。/transform:dispret 選項會將型別程式庫中分派介面上之方法的所有 [out, retval] 參數,轉換為 Managed 程式庫中的傳回值。

tlbimp TestLib.dll /transform:dispret /out:myTestLib.dll

前一個範例中的 TestLib.dll 型別程式庫包括名為 SomeMethod 的分派介面,會傳回虛值 (Void),並具有 [out, retval] 參數。以下程式碼是 TestLib.dllSomeMethod 的輸入型別程式庫方法簽章。

void SomeMethod([out, retval] VARIANT_BOOL*);

指定 /transform:dispret 選項會使 causes Tlbimp.exe 將 SomeMethod [out, retval] 參數轉換為 bool 傳回值。下列是指定 /transform:dispret 選項時,Tlbimp.exe 在 myTestLib.dll Managed 程式庫中為 SomeMethod 產生的方法簽章。

bool SomeMethod();

如果您使用 Tlbimp.exe 為 TestLib.dll 產生 Managed 程式庫,而不指定 /transform:dispret,則工具會在 myTestLib.dll Managed 程式庫中為 SomeMethod 產生下列方法簽章。

void SomeMethod(out bool x);

請參閱

參考

.NET Framework 工具
型別程式庫匯出工具 (Tlbexp.exe)
MSIL 反組譯工具 (Ildasm.exe)
強式名稱工具 (Sn.exe)
SDK 命令提示字元

概念

匯入型別程式庫做為組件
強式名稱的組件
將型別程式庫匯入 Interop 組件的屬性

其他資源

型別程式庫至組件轉換的摘要