ResolveComReference – úloha
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 trueumí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é se předávají vytvářeným tlbimp.exe a aximp.exe kromě normálního bloku prostředí nebo selektivně přepisují. |
ExecuteAsTool |
Volitelný Boolean parametr.Pokud truese spustí tlbimp.exe a aximp.exe z příslušné cílové architektury, aby se vygenerovala potřebná sestavení obálky. Tento parametr umožňuje cílení na více verzí. |
IncludeVersionInInteropName |
Volitelný Boolean parametr.Pokud truebude 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říznaku tlbimp.exe/počítače. 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 metadataPokud truevlož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 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ý Boolean parametr.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 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 projekt sestavit 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.