Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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.
Parameters
Následující tabulka popisuje parametry ResolveCOMReference úlohy.
| Parameter | Description |
|---|---|
DelaySign |
Volitelný parametr Boolean.Pokud trueumístí veřejný klíč do sestavení. Pokud false, plně podepíše sestavení. |
EnvironmentVariables |
Volitelný parametr String[].Pole párů proměnných prostředí oddělených znaménky rovná se Tyto proměnné se předávají do vytvářeného tlbimp.exe a aximp.exe kromě normálního bloku prostředí nebo selektivně přepisují. |
ExecuteAsTool |
Volitelný parametr Boolean.Pokud true, 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ý parametr Boolean.Pokud trueje verze knihovny typů zahrnuta do názvu obálky. Výchozí hodnota je false. |
KeyContainer |
Volitelný parametr String.Určuje kontejner, který obsahuje dvojici veřejného a privátního klíče. |
KeyFile |
Volitelný parametr String.Určuje položku, která obsahuje pár veřejného a privátního klíče. |
NoClassMembers |
Volitelný parametr Boolean. |
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ý parametr System.String. Pokud ExecuteAsTool ano true, musí být tento parametr nastaven na cestu nástrojů sady SDK pro cílovou verzi rozhraní. |
StateFile |
Volitelný parametr String.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ý parametr String.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ý parametr String.Určuje upřednostňovanou cílovou architekturu procesoru. Předáno příznakutlbimp.exe/machine po překladu. Hodnota parametru by měla být členem ProcessorArchitecture. |
TypeLibFiles |
Volitelný parametr ITaskItem[].Určuje cestu k souboru knihovny typů odkazům modelu COM. Položky zahrnuté v tomto parametru mohou obsahovat metadata položek. Další informace najdete v části Metadata položky TypeLibFiles. |
TypeLibNames |
Volitelný parametr ITaskItem[].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 naleznete v části TypeLibNames metadata položky. |
WrapperOutputDirectory |
Volitelný parametr String.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 | Description |
|---|---|
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ů. Tento identifikátor je určen jako 32bitová hodnota, která identifikuje lidský jazyk, který preferuje uživatel, oblast nebo aplikace. Pokud tato metadata položky nejsou zadána, úloha použije 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 knihoven typů 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 | Description |
|---|---|
EmbedInteropTypes |
Volitelný parametr Boolean.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 knihoven typů 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. |
Note
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.
Remarks
Kromě parametrů uvedených v tomto článku dědí tato úloha parametry z Task třídy. Seznam těchto dalších parametrů a jejich popisů najdete v tématu Základní třída úlohy.
Aby tato úloha fungovala, nemusí být na počítači zaregistrovaná knihovna DLL modelu COM.
MSB4803 Error
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 tento spustitelný soubor používá verzi rozhraní .NET Framework nástroje MSBuild.