ResolveComReference, zadanie
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 trueparametr umieszcza klucz publiczny w zestawie. Jeśli falseelement , w pełni podpisuje zestaw. |
EnvironmentVariables |
Opcjonalny String[] parametr.Tablica par zmiennych środowiskowych oddzielona znakami równości. Te zmienne są przekazywane do zduplikowanych tlbimp.exe i aximp.exe oprócz lub selektywnie przesłaniania zwykłego bloku środowiskowego. |
ExecuteAsTool |
Opcjonalny Boolean parametr.Jeśli trueprogram uruchamia 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 trueparametr , 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 truewartość , 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/maszyny 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 trueparametr , 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 Primary TLBImp 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 Boolean parametr.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. |
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 MSBuild.exe z poziomu wiersza polecenia dla deweloperów programu Visual Studio, ponieważ używa to programu .NET Framework w wersji MSBuild.