ResolveComReference 工作

更新：2007 年 11 月

取得一或多個型別程式庫名稱或 .tlb 檔的清單，並將那些型別程式庫解析至磁碟上的位置。

參數

下表列出 ResolveCOMReference 工作的參數及其概略說明。

參數	說明
DelaySign	選擇性 Boolean 參數。如果為 true，工作便會將公開金鑰 (Public Key) 置於組件中。如果為 false，工作便會對組件完整簽章。
KeyContainer	選擇性 String 參數。指定保留金鑰組的容器。
KeyFile	選擇性 String 參數。指定包含金鑰組的項目。
NoClassMembers	選擇性 Boolean 參數。
ResolvedAssemblyReferences	選擇性 ITaskItem[] 輸出參數。指定解析的組件參考。
ResolvedFiles	選擇性 ITaskItem[] 輸出參數。指定磁碟上對應到型別程式庫實體位置的完整檔案，這些型別程式庫是提供做為這個工作的輸出。
ResolvedModules	選擇性 ITaskItem[] 參數。
TypeLibFiles	選擇性 ITaskItem[] 參數。指定 COM 參考的型別程式庫檔案路徑。此參數所包含的項目可能會包含項目中繼資料 (Metadata)。如需詳細資訊，請參閱以下的「TypeLibFiles 項目中繼資料」一節。
TypeLibNames	選擇性 ITaskItem[] 參數。指定要解析的型別程式庫名稱。此參數所包含的項目必須包含某些項目中繼資料。如需詳細資訊，請參閱以下的「TypeLibNames 項目中繼資料」一節。
WrapperOutputDirectory	選擇性 String 參數。所產生 Interop 組件在磁碟上的位置。如果未指定這個項目中繼資料，則工作會使用專案檔所在目錄的絕對路徑。

下表針對傳遞至 TypeLibNames 參數的項目，說明項目可用的中繼資料。

中繼資料	說明
GUID	必要的項目中繼資料。型別程式庫的 GUID。如果未指定這個項目中繼資料，則工作會失敗。
VersionMajor	必要的項目中繼資料。型別程式庫的主要版本。如果未指定這個項目中繼資料，則工作會失敗。
VersionMinor	必要的項目中繼資料。型別程式庫的次要版本。如果未指定這個項目中繼資料，則工作會失敗。
LocaleIdentifier	選擇性項目中繼資料。型別程式庫的地區設定識別項 (或稱為 LCID)。此項目是指定為 32 位元值，此值可辨識使用者、區域或應用程式慣用的人類語言。如果未指定這個項目中繼資料，則工作會使用預設的地區設定識別項 "0"。
WrapperTool	選擇性項目中繼資料。指定包裝函式工具，此工具可用來針對這個型別程式庫產生組件包裝函式。如果未指定這個項目中繼資料，則工作會使用預設的包裝函式工具 "tlbimp"。不區分大小寫的可用 typelib 選項如下： Primary：如果要針對 COM 元件使用已產生的主要 Interop 組件，請使用這個包裝函式工具。使用這個包裝函式工具時，請勿指定包裝函式輸出目錄，因為那樣會造成工作失敗。 TLBImp：如果要針對 COM 元件產生 Interop 組件，請使用這個包裝函式工具。 AXImp：如果要要針對 ActiveX 元件產生 Interop 組件，請使用這項包裝函式工具。

下表針對傳遞至 TypeLibFiles 參數的項目，說明項目可用的中繼資料。

中繼資料	說明
WrapperTool	選擇性項目中繼資料。指定包裝函式工具，此工具可用來針對這個型別程式庫產生組件包裝函式。如果未指定這個項目中繼資料，則工作會使用預設的包裝函式工具 "tlbimp"。不區分大小寫的可用 typelib 選項如下： Primary：如果要針對 COM 元件使用已產生的主要 Interop 組件，請使用這個包裝函式工具。使用這個包裝函式工具時，請勿指定包裝函式輸出目錄，因為那樣會造成工作失敗。 TLBImp：如果要針對 COM 元件產生 Interop 組件，請使用這個包裝函式工具。 AXImp：如果要針對 ActiveX 元件產生 Interop 組件，請使用這個包裝函式工具。

WrapperTool

選擇性項目中繼資料。

指定包裝函式工具，此工具可用來針對這個型別程式庫產生組件包裝函式。如果未指定這個項目中繼資料，則工作會使用預設的包裝函式工具 "tlbimp"。不區分大小寫的可用 typelib 選項如下：

Primary：如果要針對 COM 元件使用已產生的主要 Interop 組件，請使用這個包裝函式工具。使用這個包裝函式工具時，請勿指定包裝函式輸出目錄，因為那樣會造成工作失敗。
TLBImp：如果要針對 COM 元件產生 Interop 組件，請使用這個包裝函式工具。
AXImp：如果要針對 ActiveX 元件產生 Interop 組件，請使用這個包裝函式工具。

注意事項：
當您提供越多資訊以唯一識別型別程式庫時，工作就越可能解析至磁碟上的正確檔案。