ResolveComReference, zadanie

Artykuł
08/25/2023

Pobiera listę co najmniej jednej nazwy bibliotek typów lub plików tlb i rozpoznaje te biblioteki typów w lokalizacjach na dysku.

Parametry

W poniższej tabeli opisano parametry ResolveCOMReference zadania.

Parametr	Opis
`DelaySign`	Opcjonalny `Boolean` parametr. Jeśli `true`parametr umieszcza klucz publiczny w zestawie. Jeśli `false`element , w pełni podpisuje zestaw.
`EnvironmentVariables`	Opcjonalny `String[]` parametr. Tablica par zmiennych środowiskowych oddzielona znakami równości. Te zmienne są przekazywane do zduplikowanego pliku tlbimp.exe i aximp.exe oprócz lub selektywnego zastępowania zwykłego bloku środowiska.
`ExecuteAsTool`	Opcjonalny `Boolean` parametr. Jeśli `true`program uruchamia plik tlbimp.exe i aximp.exe z odpowiedniej struktury docelowej out-of-proc w celu wygenerowania niezbędnych zestawów otoki. Ten parametr umożliwia korzystanie z wielu elementów docelowych.
`IncludeVersionInInteropName`	Opcjonalny `Boolean` parametr. Jeśli `true`parametr , wersja biblioteki typelib zostanie uwzględniona w nazwie otoki. Wartość domyślna to `false`.
`KeyContainer`	Opcjonalny `String` parametr. Określa kontener, który przechowuje parę kluczy publicznych/prywatnych.
`KeyFile`	Opcjonalny `String` parametr. Określa element, który zawiera parę kluczy publicznych/prywatnych.
`NoClassMembers`	Opcjonalny `Boolean`parametr.
`ResolvedAssemblyReferences`	Opcjonalny ITaskItem`[]` parametr wyjściowy. Określa rozpoznane odwołania do zestawów.
`ResolvedFiles`	Opcjonalny ITaskItem`[]` parametr wyjściowy. Określa w pełni kwalifikowane pliki na dysku, które odpowiadają fizycznym lokalizacjom bibliotek typów, które zostały dostarczone jako dane wejściowe tego zadania.
`ResolvedModules`	Opcjonalny ITaskItem`[]`parametr.
`SdkToolsPath`	Opcjonalny System.String parametr. Jeśli `ExecuteAsTool` parametr ma `true`wartość , ten parametr musi być ustawiony na ścieżkę narzędzi zestawu SDK dla docelowej wersji platformy.
`StateFile`	Opcjonalny `String` parametr. Określa plik pamięci podręcznej dla sygnatur czasowych składników COM. Jeśli nie jest obecny, każde uruchomienie ponownie wygeneruje wszystkie otoki.
`TargetFrameworkVersion`	Opcjonalny `String` parametr. Określa wersję platformy docelowej projektu. Wartość domyślna to `String.Empty`. oznacza to, że nie ma filtrowania odwołania na podstawie struktury docelowej.
`TargetProcessorArchitecture`	Opcjonalny `String` parametr. Określa preferowaną architekturę procesora docelowego. Przekazano do flagi tlbimp.exe/machine po tłumaczeniu. Wartość parametru ProcessorArchitecturepowinna być elementem członkowskim .
`TypeLibFiles`	Opcjonalny ITaskItem`[]` parametr. Określa ścieżkę pliku biblioteki typów do odwołań COM. Elementy zawarte w tym parametrze mogą zawierać metadane elementu. Aby uzyskać więcej informacji, zobacz sekcję TypeLibFiles metadanych elementu poniżej.
`TypeLibNames`	Opcjonalny ITaskItem`[]` parametr. Określa nazwy bibliotek typów do rozpoznania. Elementy zawarte w tym parametrze muszą zawierać metadane elementu. Aby uzyskać więcej informacji, zobacz sekcję TypeLibNames metadanych elementu poniżej.
`WrapperOutputDirectory`	Opcjonalny `String` parametr. Lokalizacja na dysku, na którym jest umieszczony wygenerowany zestaw międzyoperamentowy. Jeśli nie określono metadanych tego elementu, zadanie używa ścieżki bezwzględnej katalogu, w którym znajduje się plik projektu.

Metadane elementu TypeLibNames

W poniższej tabeli opisano metadane elementu dostępne dla elementów przekazanych do parametru TypeLibNames .

Metadane	opis
`GUID`	Wymagane metadane elementu. Identyfikator GUID biblioteki typów. Jeśli te metadane elementu nie zostaną określone, zadanie zakończy się niepowodzeniem.
`VersionMajor`	Wymagane metadane elementu. Główna wersja biblioteki typów. Jeśli te metadane elementu nie zostaną określone, zadanie zakończy się niepowodzeniem.
`VersionMinor`	Wymagane metadane elementu. Wersja pomocnicza biblioteki typów. Jeśli te metadane elementu nie zostaną określone, zadanie zakończy się niepowodzeniem.
`EmbedInteropTypes`	Opcjonalne `Boolean` metadane. Jeśli `true`parametr , osadź typy międzyoperacyjności z tego odwołania bezpośrednio do zestawu, a nie generując biblioteki DLL międzyoperacyjności.
`LocaleIdentifier`	Opcjonalne metadane elementu. Identyfikator ustawień regionalnych (lub LCID) dla biblioteki typów. Jest to określane jako wartość 32-bitowa, która identyfikuje język ludzki preferowany przez użytkownika, region lub aplikację. Jeśli te metadane elementu nie są określone, zadanie używa domyślnego identyfikatora ustawień regionalnych "0".
`WrapperTool`	Opcjonalne metadane elementu. Określa narzędzie otoki używane do generowania otoki zestawów dla tej biblioteki typów. Jeśli nie określono tych metadanych elementu, zadanie używa domyślnego narzędzia otoki "tlbimp". Dostępne opcje bez uwzględniania wielkości liter to: - `Primary`: użyj tego narzędzia otoki, jeśli chcesz użyć już wygenerowanego podstawowego zestawu międzyoperajowego dla składnika COM. Jeśli używasz tego narzędzia otoki, nie należy określać katalogu wyjściowego otoki, ponieważ spowoduje to niepowodzenie zadania. - `TLBImp`: użyj tego narzędzia otoki, aby wygenerować zestaw międzyoperajowy dla składnika COM. - `PrimaryOrTLBImp`: Użyj tego narzędzia otoki, gdy nie masz pewności, czy `PrimaryTLBImp` jest to odpowiednie. Logika `Primary` jest stosowana najpierw, a następnie `TLBImp`. - `AXImp`:Użyj tego narzędzia otoki, jeśli chcesz wygenerować zestaw międzyoperacjonowy dla kontrolki ActiveX.

Metadane elementu TypeLibFiles

W poniższej tabeli opisano metadane elementu dostępne dla elementów przekazanych do parametru TypeLibFiles .

Metadane opis

EmbedInteropTypes Opcjonalny Booleanparametr.

Jeśli trueparametr , osadź typy międzyoperacyjności z tego odwołania bezpośrednio do zestawu, a nie generując biblioteki DLL międzyoperacyjności.

WrapperTool Opcjonalne metadane elementu.

Określa narzędzie otoki używane do generowania otoki zestawów dla tej biblioteki typów. Jeśli nie określono tych metadanych elementu, zadanie używa domyślnego narzędzia otoki "tlbimp". Dostępne opcje bez uwzględniania wielkości liter to:

- Primary: użyj tego narzędzia otoki, jeśli chcesz użyć już wygenerowanego podstawowego zestawu międzyoperajowego dla składnika COM. Jeśli używasz tego narzędzia otoki, nie należy określać katalogu wyjściowego otoki, ponieważ spowoduje to niepowodzenie zadania.
- TLBImp: użyj tego narzędzia otoki, aby wygenerować zestaw międzyoperajowy dla składnika COM.
- AXImp: Użyj tego narzędzia otoki, jeśli chcesz wygenerować zestaw międzyoperacjonowy dla kontrolki ActiveX.

Metadane	opis
`EmbedInteropTypes`	Opcjonalny `Boolean`parametr. Jeśli `true`parametr , osadź typy międzyoperacyjności z tego odwołania bezpośrednio do zestawu, a nie generując biblioteki DLL międzyoperacyjności.
`WrapperTool`	Opcjonalne metadane elementu. Określa narzędzie otoki używane do generowania otoki zestawów dla tej biblioteki typów. Jeśli nie określono tych metadanych elementu, zadanie używa domyślnego narzędzia otoki "tlbimp". Dostępne opcje bez uwzględniania wielkości liter to: - `Primary`: użyj tego narzędzia otoki, jeśli chcesz użyć już wygenerowanego podstawowego zestawu międzyoperajowego dla składnika COM. Jeśli używasz tego narzędzia otoki, nie należy określać katalogu wyjściowego otoki, ponieważ spowoduje to niepowodzenie zadania. - `TLBImp`: użyj tego narzędzia otoki, aby wygenerować zestaw międzyoperajowy dla składnika COM. - `AXImp`: Użyj tego narzędzia otoki, jeśli chcesz wygenerować zestaw międzyoperacjonowy dla kontrolki ActiveX.

Uwaga

Im więcej informacji, które podajesz w celu unikatowego identyfikowania biblioteki typów, tym większa jest możliwość rozpoznania zadania w prawidłowym pliku na dysku.

Uwagi

Oprócz parametrów wymienionych powyżej to zadanie dziedziczy parametry z Task klasy. Aby uzyskać listę tych dodatkowych parametrów i ich opisy, zobacz Klasa podstawowa zadania.

Biblioteka DLL COM nie musi być zarejestrowana na maszynie, aby to zadanie działało.

błąd MSB4803

Jeśli spróbujesz uruchomić projekt, który używa ResolveCOMReference zadania z poleceń interfejsu dotnet wiersza polecenia, zostanie wyświetlony błąd:

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

To zadanie nie jest obsługiwane w wersji msBuild platformy .NET Core, która jest używana podczas uruchamiania dotnet build polecenia z wiersza polecenia. Spróbuj skompilować projekt, wywołując plik MSBuild.exe z wiersza polecenia dla deweloperów programu Visual Studio, ponieważ używa to wersji programu .NET Framework programu MSBuild.