ResolveComReference – úloha

Článek
10/13/2023

Vezme seznam jednoho nebo více názvů knihoven typů nebo souborů .tlb a přeloží tyto knihovny typů na umístění na disku.

Parametry

Následující tabulka popisuje parametry ResolveCOMReference úlohy.

Parametr	Popis
`DelaySign`	Volitelný `Boolean` parametr. Pokud `true`umístí veřejný klíč do sestavení. Pokud `false`, plně podepíše sestavení.
`EnvironmentVariables`	Volitelný `String[]` parametr. Pole párů proměnných prostředí oddělených znaménky rovná se Tyto proměnné jsou předány spawned tlbimp.exe a aximp.exe kromě nebo selektivní přepsání pravidelného bloku prostředí..
`ExecuteAsTool`	Volitelný `Boolean` parametr. Pokud `true`, spustí tlbimp.exe a aximp.exez příslušné cílové architektury out-of-proc vygenerovat nezbytné obálky sestavení. Tento parametr umožňuje cílení na více verzí.
`IncludeVersionInInteropName`	Volitelný `Boolean` parametr. Pokud `true`bude verze typelib zahrnuta do názvu obálky. Výchozí hodnota je `false`.
`KeyContainer`	Volitelný `String` parametr. Určuje kontejner, který obsahuje dvojici veřejného a privátního klíče.
`KeyFile`	Volitelný `String` parametr. Určuje položku, která obsahuje pár veřejného a privátního klíče.
`NoClassMembers`	Volitelný `Boolean`parametr.
`ResolvedAssemblyReferences`	Volitelný ITaskItem`[]` výstupní parametr. Určuje vyřešené odkazy na sestavení.
`ResolvedFiles`	Volitelný ITaskItem`[]` výstupní parametr. Určuje plně kvalifikované soubory na disku, které odpovídají fyzickým umístěním knihoven typů, které byly poskytnuty jako vstup pro tuto úlohu.
`ResolvedModules`	Volitelný ITaskItem`[]`parametr.
`SdkToolsPath`	Volitelný System.String parametr. Pokud `ExecuteAsTool` ano `true`, musí být tento parametr nastaven na cestu nástrojů sady SDK pro cílovou verzi rozhraní.
`StateFile`	Volitelný `String` parametr. Určuje soubor mezipaměti pro časová razítka součástí modelu COM. Pokud není k dispozici, každé spuštění znovu vygeneruje všechny obálky.
`TargetFrameworkVersion`	Volitelný `String` parametr. Určuje verzi cílové architektury projektu. Výchozí hodnota je `String.Empty`. což znamená, že neexistuje žádné filtrování odkazu na základě cílové architektury.
`TargetProcessorArchitecture`	Volitelný `String` parametr. Určuje upřednostňovanou cílovou architekturu procesoru. Po překladu se předá příznak tlbimp.exe/machine. Hodnota parametru by měla být členem ProcessorArchitecture.
`TypeLibFiles`	Volitelný ITaskItem`[]` parametr. Určuje cestu k souboru knihovny typů odkazům modelu COM. Položky zahrnuté v tomto parametru mohou obsahovat metadata položek. Další informace naleznete v části TypeLibFiles metadata položky níže.
`TypeLibNames`	Volitelný ITaskItem`[]` parametr. Určuje názvy knihoven typů, které se mají přeložit. Položky zahrnuté v tomto parametru musí obsahovat metadata některých položek. Další informace najdete v části TypeLibNames metadata položky níže.
`WrapperOutputDirectory`	Volitelný `String` parametr. Umístění na disku, kde je umístěné vygenerované sestavení vzájemné spolupráce. Pokud tato metadata položky nejsou zadána, použije úkol absolutní cestu k adresáři, kde je umístěn soubor projektu.

Metadata položky TypeLibNames

Následující tabulka popisuje metadata položek, která jsou k dispozici pro položky předané parametru TypeLibNames .

Metadata	Popis
`GUID`	Požadovaná metadata položek Identifikátor GUID pro knihovnu typů. Pokud nejsou zadána metadata této položky, úloha selže.
`VersionMajor`	Požadovaná metadata položek Hlavní verze knihovny typů. Pokud nejsou zadána metadata této položky, úloha selže.
`VersionMinor`	Požadovaná metadata položek Podverze knihovny typů. Pokud nejsou zadána metadata této položky, úloha selže.
`EmbedInteropTypes`	Volitelná `Boolean` metadata Pokud `true`vložte typy vzájemné spolupráce z tohoto odkazu přímo do sestavení místo generování knihovny DLL vzájemné spolupráce.
`LocaleIdentifier`	Volitelná metadata položek Identifikátor národního prostředí (nebo LCID) pro knihovnu typů. Tato hodnota se určuje jako 32bitová hodnota, která identifikuje lidský jazyk, který preferuje uživatel, oblast nebo aplikace. Pokud tato metadata položky nejsou zadána, použije úloha výchozí identifikátor národního prostředí 0.
`WrapperTool`	Volitelná metadata položek Určuje nástroj obálky, který se používá k vygenerování obálky sestavení pro tuto knihovnu typů. Pokud tato metadata položky nejsou zadána, použije úloha výchozí nástroj obálky tlbimp. Dostupné možnosti typelib nerozlišují malá a velká písmena: - `Primary`: Tento nástroj obálky použijte, pokud chcete pro komponentu COM použít již vygenerované primární sestavení vzájemné spolupráce. Při použití tohoto nástroje obálky nezadávejte výstupní adresář obálky, protože to způsobí selhání úlohy. - `TLBImp`: Tento nástroj obálky použijte, pokud chcete vygenerovat sestavení vzájemné spolupráce pro komponentu COM. - `PrimaryOrTLBImp`: Tento nástroj obálky použijte, pokud si nejste jisti, zda `Primary` je nebo `TLBImp` je vhodný. Logika `Primary` se použije nejprve a pak `TLBImp`. - `AXImp`:Tento nástroj obálky použijte, pokud chcete vygenerovat sestavení vzájemné spolupráce pro ovládací prvek technologie ActiveX.

Metadata položky TypeLibFiles

Následující tabulka popisuje metadata položek, která jsou k dispozici pro položky předané parametru TypeLibFiles .

Metadata Popis

EmbedInteropTypes Volitelný Booleanparametr.

Pokud truevložte typy vzájemné spolupráce z tohoto odkazu přímo do sestavení místo generování knihovny DLL vzájemné spolupráce.

WrapperTool Volitelná metadata položek

Určuje nástroj obálky, který se používá k vygenerování obálky sestavení pro tuto knihovnu typů. Pokud tato metadata položky nejsou zadána, použije úloha výchozí nástroj obálky tlbimp. Dostupné možnosti typelib nerozlišují malá a velká písmena:

- Primary: Tento nástroj obálky použijte, pokud chcete pro komponentu COM použít již vygenerované primární sestavení vzájemné spolupráce. Při použití tohoto nástroje obálky nezadávejte výstupní adresář obálky, protože to způsobí selhání úlohy.
- TLBImp: Tento nástroj obálky použijte, pokud chcete vygenerovat sestavení vzájemné spolupráce pro komponentu COM.
- AXImp: Tento nástroj obálky použijte, pokud chcete vygenerovat sestavení vzájemné spolupráce pro ovládací prvek technologie ActiveX.

Metadata	Popis
`EmbedInteropTypes`	Volitelný `Boolean`parametr. Pokud `true`vložte typy vzájemné spolupráce z tohoto odkazu přímo do sestavení místo generování knihovny DLL vzájemné spolupráce.
`WrapperTool`	Volitelná metadata položek Určuje nástroj obálky, který se používá k vygenerování obálky sestavení pro tuto knihovnu typů. Pokud tato metadata položky nejsou zadána, použije úloha výchozí nástroj obálky tlbimp. Dostupné možnosti typelib nerozlišují malá a velká písmena: - `Primary`: Tento nástroj obálky použijte, pokud chcete pro komponentu COM použít již vygenerované primární sestavení vzájemné spolupráce. Při použití tohoto nástroje obálky nezadávejte výstupní adresář obálky, protože to způsobí selhání úlohy. - `TLBImp`: Tento nástroj obálky použijte, pokud chcete vygenerovat sestavení vzájemné spolupráce pro komponentu COM. - `AXImp`: Tento nástroj obálky použijte, pokud chcete vygenerovat sestavení vzájemné spolupráce pro ovládací prvek technologie ActiveX.

Poznámka

Další informace, které zadáte k jednoznačné identifikaci knihovny typů, tím větší je možnost, že se úloha přeloží na správný soubor na disku.

Poznámky

Kromě výše uvedených parametrů dědí tato úloha parametry z Task třídy. Seznam těchto dalších parametrů a jejich popisů naleznete v části Základní třída úlohy.

Aby tato úloha fungovala, nemusí být na počítači zaregistrovaná knihovna DLL modelu COM.

Chyba MSB4803

Pokud se pokusíte spustit projekt, který používá ResolveCOMReference úlohu z příkazů rozhraní příkazového dotnet řádku, zobrazí se tato chyba:

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

Tato úloha není podporována ve verzi .NET Core nástroje MSBuild, která se používá při spuštění dotnet build příkazu z příkazového řádku. Zkuste sestavit projekt vyvoláním msBuild.exe z příkazového řádku pro vývojáře sady Visual Studio, protože používá verzi rozhraní .NET Framework nástroje MSBuild.