ResolveComReference 工作

  • 發行項

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

參數

下表說明 ResolveCOMReference 工作的參數。

參數 描述
DelaySign 選擇性的 Boolean 參數。

如為 true，則將公開金鑰放在組件中。 如為 false，則完整簽署組件。
EnvironmentVariables 選擇性的 String[] 參數。

環境變數組陣列，以等號分隔。 這些變數是在規則環境區塊以外傳遞至繁衍的 tlbimp.exe 和 aximp.exe，或選擇性地覆寫。
ExecuteAsTool 選擇性的 Boolean 參數。

如果為 true，會從適當目標 Framework 跨處理序執行 tlbimp.exe 和 aximp.exe，以產生必要的包裝函式組件。 此參數會啟用多目標。
IncludeVersionInInteropName 選擇性的 Boolean 參數。

如為 true，則包裝函式名稱會包含 TypeLib 版本。 預設值為 false。
KeyContainer 選擇性的 String 參數。

指定持有公開/私密金鑰組的容器。
KeyFile 選擇性的 String 參數。

指定包含公開/私密金鑰組的項目。
NoClassMembers 選擇性的 Boolean 參數。
ResolvedAssemblyReferences 選擇性的 ITaskItem[] 輸出參數。

指定已解析的組件參考。
ResolvedFiles 選擇性的 ITaskItem[] 輸出參數。

指定磁碟上的完整檔案，這個磁碟對應至已提供作為這項工作輸入之類型程式庫的實體位置。
ResolvedModules 選擇性的 ITaskItem[] 參數。
SdkToolsPath 選擇性的 System.String 參數。

如果 ExecuteAsTool 是 true，則此參數必須設定為目標 Framework 版本的 SDK 工具路徑。
StateFile 選擇性的 String 參數。

指定 COM 元件時間戳記的快取檔案。 如果沒有，則每次執行都會重新產生所有的包裝函式。
TargetFrameworkVersion 選擇性的 String 參數。

指定專案目標 Framework 版本。

預設值為 String.Empty。 這表示不篩選以目標 Framework 為基礎的參考。
TargetProcessorArchitecture 選擇性的 String 參數。

指定慣用的目標處理器架構。 平移後，傳遞至 tlbimp.exe/machine 旗標。

參數值應該是 ProcessorArchitecture 的成員。
TypeLibFiles 選擇性的 ITaskItem[] 參數。

指定 COM 參考的類型程式庫檔案路徑。 此參數中包含的項目可能包含項目中繼資料。 如需詳細資訊，請參閱下面的 TypeLibFiles 項目中繼資料一節。
TypeLibNames 選擇性的 ITaskItem[] 參數。

指定要解析的類型程式庫名稱。 此參數中包含的項目必須包含某些項目中繼資料。 如需詳細資訊，請參閱下面的 TypeLibNames 項目中繼資料一節。
WrapperOutputDirectory 選擇性的 String 參數。

產生的 interop 組件在磁碟上所在位置。 如未指定此項目中繼資料，工作會使用專案檔所在目錄的絕對路徑。

TypeLibNames 項目中繼資料

下表描述將項目傳遞給 TypeLibNames 參數的可用項目中繼資料。

中繼資料 描述
GUID 必要的項目中繼資料。

類型程式庫的 GUID。 如未指定此項目中繼資料，則工作會失敗。
VersionMajor 必要的項目中繼資料。

類型程式庫的主要版本。 如未指定此項目中繼資料，則工作會失敗。
VersionMinor 必要的項目中繼資料。

類型程式庫的次要版本。 如未指定此項目中繼資料，則工作會失敗。
EmbedInteropTypes 選擇性的 Boolean 中繼資料。

若為 true，就會將 Interop 類型從這個參考直接內嵌到您的組件中，而不是產生 Interop DLL。
LocaleIdentifier 選擇性項目中繼資料。

類型程式庫的地區設定識別碼 (或 LCID)。 這會指定為 32 位元值，識別使用者、區域或應用程式慣用的人類語言。 如未指定此項目中繼資料，工作會使用預設的地區設定識別碼 "0"。
WrapperTool 選擇性項目中繼資料。

指定為此類型程式庫產生組件包裝函式使用的包裝函式工具。 如未指定此項目中繼資料，工作會使用預設的包裝函式工具 "tlbimp"。 可用且不區分大小寫的 TypeLib 選項有：

- Primary：當您想要使用 COM 元件已產生的主要 Interop 組件時，請使用此包裝函式工具。 當您使用此包裝函式工具時，請勿指定包裝函式的輸出目錄，因為這會造成工作失敗。
- TLBImp：當您想要產生 COM 元件的 Interop 組件時，請使用此包裝函式工具。
- PrimaryOrTLBImp：當您不確定 Primary 或 TLBImp 是否適當時，請使用這個包裝函式工具。 會先套用 Primary 邏輯，然後套用 TLBImp。
- AXImp：當您想要產生 ActiveX 控制項的 Interop 組件時，請使用此包裝函式工具。

TypeLibFiles 項目中繼資料

下表描述將項目傳遞給 TypeLibFiles 參數的可用項目中繼資料。

中繼資料 描述
EmbedInteropTypes 選擇性的 Boolean 參數。

若為 true，就會將 Interop 類型從這個參考直接內嵌到您的組件中，而不是產生 Interop DLL。
WrapperTool 選擇性項目中繼資料。

指定為此類型程式庫產生組件包裝函式使用的包裝函式工具。 如未指定此項目中繼資料，工作會使用預設的包裝函式工具 "tlbimp"。 可用且不區分大小寫的 TypeLib 選項有：

- Primary：當您想要使用 COM 元件已產生的主要 Interop 組件時，請使用此包裝函式工具。 當您使用此包裝函式工具時，請勿指定包裝函式的輸出目錄，因為這會造成工作失敗。
- TLBImp：當您想要產生 COM 元件的 Interop 組件時，請使用此包裝函式工具。
- AXImp：當您想要產生 ActiveX 控制項的 Interop 組件時，請使用此包裝函式工具。

注意

您為唯一識別類型程式庫所提供的資訊愈詳細，工作解析至正確磁碟檔案的可能性就愈大。

備註

除了上述所列的參數，這項工作也會從 Task 類別繼承參數。 如需這些其他參數的清單及其說明，請參閱 Task 基底類別。

COM DLL 無須在機器上註冊，此工作便能運作。

MSB4803 錯誤

如果您嘗試從 dotnet CLI 命令執行使用 ResolveCOMReference 工作的專案，您會收到錯誤：

MSB4803: The task "ResolveComReference" is not supported on the .NET Core version of MSBuild. Please use the .NET Framework version of MSBuild.

MSBuild 的 .NET Core 版本不支援這項工作，這是當您從命令列執行 dotnet build 命令時所使用的工作。 嘗試從 Visual Studio 開發人員命令提示字元叫用 MSBuild.exe 來建置專案，因為這會使用 MSBuild 的 .NET Framework 版本。

另請參閱