Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Pobiera listę co najmniej jednej nazwy bibliotek typów lub plików tlb i rozpoznaje te biblioteki typów w lokalizacjach na dysku.
Parameters
W poniższej tabeli opisano parametry zadania ResolveCOMReference.
| Parameter | Description |
|---|---|
DelaySign |
Opcjonalny parametr Boolean.Jeśli trueparametr umieszcza klucz publiczny w zestawie. Jeśli falseelement , w pełni podpisuje zestaw. |
EnvironmentVariables |
Opcjonalny parametr String[].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 parametr Boolean.Jeśli true, 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 parametr Boolean.Jeśli truewersja biblioteki typów jest uwzględniona w nazwie otoki. Wartość domyślna to false. |
KeyContainer |
Opcjonalny parametr String.Określa kontener, który przechowuje parę kluczy publicznych/prywatnych. |
KeyFile |
Opcjonalny parametr String.Określa element, który zawiera parę kluczy publicznych/prywatnych. |
NoClassMembers |
Opcjonalny parametr Boolean. |
ResolvedAssemblyReferences |
Opcjonalny parametr wyjściowy ITaskItem[].Określa rozpoznane odwołania do zestawów. |
ResolvedFiles |
Opcjonalny parametr wyjściowy ITaskItem[].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 parametr System.String. Jeśli ExecuteAsTool parametr ma truewartość , ten parametr musi być ustawiony na ścieżkę narzędzi zestawu SDK dla docelowej wersji platformy. |
StateFile |
Opcjonalny parametr String.Określa plik pamięci podręcznej dla sygnatur czasowych składników COM. Jeśli nie jest obecny, każdy przebieg ponownie generuje wszystkie otoki. |
TargetFrameworkVersion |
Opcjonalny parametr String.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 parametr String.Określa preferowaną architekturę procesora docelowego. Przekazano do flagitlbimp.exe/machine po tłumaczeniu. Wartość parametru ProcessorArchitecturepowinna być elementem członkowskim . |
TypeLibFiles |
Opcjonalny parametr ITaskItem[].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ę Metadane elementu TypeLibFiles. |
TypeLibNames |
Opcjonalny parametr ITaskItem[].Określa nazwy bibliotek typów do rozpoznania. Elementy zawarte w tym parametrze muszą zawierać metadane elementu. Aby uzyskać więcej informacji, zobacz sekcję Metadane elementu TypeLibNames. |
WrapperOutputDirectory |
Opcjonalny parametr String.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 .
| Metadata | Description |
|---|---|
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. Ten identyfikator jest określany jako wartość 32-bitowa, która identyfikuje język ludzki preferowany przez użytkownika, region lub aplikację. Jeśli nie określono metadanych tego elementu, 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 te metadane elementu nie zostaną określone, zadanie używa domyślnego narzędzia otoki "tlbimp". Dostępne opcje bez uwzględniania wielkości liter w bibliotekach typów to: - Primary: użyj tego narzędzia otoki, jeśli chcesz użyć już wygenerowanego podstawowego zestawu międzyoperajowego dla składnika COM. W przypadku korzystania z tego narzędzia otoki nie należy określać katalogu wyjściowego otoki, ponieważ powoduje 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 .
| Metadata | Description |
|---|---|
EmbedInteropTypes |
Opcjonalny parametr Boolean.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 te metadane elementu nie zostaną określone, zadanie używa domyślnego narzędzia otoki "tlbimp". Dostępne opcje bez uwzględniania wielkości liter w bibliotekach typów to: - Primary: użyj tego narzędzia otoki, jeśli chcesz użyć już wygenerowanego podstawowego zestawu międzyoperajowego dla składnika COM. W przypadku korzystania z tego narzędzia otoki nie należy określać katalogu wyjściowego otoki, ponieważ powoduje 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. |
Note
Im więcej informacji, które podajesz w celu unikatowego identyfikowania biblioteki typów, tym większa jest możliwość rozpoznania przez zadanie poprawnego pliku na dysku.
Remarks
Oprócz parametrów wymienionych w tym artykule to zadanie dziedziczy parametry z Task klasy. Aby uzyskać listę tych dodatkowych parametrów i ich opisów, zobacz klasa bazowa zadań.
Biblioteka DLL COM nie musi być zarejestrowana na maszynie, aby to zadanie działało.
MSB4803 Error
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ż ten plik wykonywalny używa wersji programu .NET Framework programu MSBuild.