Sdílet prostřednictvím

ResolveAssemblyReference – úloha

  • Článek

Určuje všechna sestavení, které závisí na zadané sestavení.To zahrnuje druhé a nth pořadí závislostí.

Parametry

Následující tabulka popisuje parametry ResolveAssemblyReference úkolu.

Parametr

Description

AllowedAssemblyExtensions

Volitelný String[] parametr.

Sestavení přípon souborů při řešení odkazů.Výchozí přípony názvů souborů, exe a DLL.

AllowedRelatedFileExtensions

Volitelný String[] parametr.

Přípony názvů souborů pro vyhledávání souborů, které se vztahují k jinému.Výchozí přípony jsou PDB a XML.

AppConfigFile

Volitelný String parametr.

Určuje soubor app.config, ze které chcete analyzovat a extrahovat bindingRedirect mapování.Pokud je tento parametr zadán, AutoUnify musí být parametr false.

AutoUnify

Volitelný Boolean parametr.

Tento parametr se používá pro vytváření sestav, jako jsou knihovny DLL, které nemohou mít normální soubor App.Config.

Při true, výsledný graf závislosti automaticky zachází jako kdyby nebyla anApp.Config soubor předaný parametru parametr AppConfigFile.Tento virtuální soubor App.Config má bindingRedirect položku pro každou konfliktní nastavení sestavení tak, že se zvolí nejvyšší verze sestavení.Důsledkem tohoto je, že nikdy bude upozornění o konfliktní sestavení protože bude každý konflikt byl vyřešen.

Při true, každý odlišné přemapování výsledkem bude komentář s vysokou prioritou staré a nové verze a který AutoUnify byla true.

Při true, parametr AppConfigFile parametr musí být prázdný.

Při false, žádné přemapování verze sestavení dojde automaticky.Pokud jsou k dispozici dvě verze sestavení, bude vydáno upozornění.

Při false, každý odlišné konflikt mezi různé verze téhož sestavení výsledků v prioritní komentář.Tyto komentáře následuje jeden upozornění.Upozornění má jedinečný kód chyby a obsahuje text, který se čte "Nalezen konflikty mezi různými verzemi odkaz a závislá sestavení".

Assemblies

Volitelný ITaskItem[] parametr.

Určuje položky, pro které musí být identifikovány závislosti a úplné cesty.Tyto položky mohou mít buď jednoduché názvy jako "Systém" nebo silné jako "systému, verze = 2.0.3500.0 kultury = neutrální, PublicKeyToken = b77a5c561934e089."

Položky předán tento parametr může mít volitelně metadata následující položky:

  • Private: Boolean value.Pokud true, pak bude položka zkopírována místně.Výchozí hodnota je true.

  • HintPath: String value.Určuje cestu a název, který chcete použít jako odkaz.Používá se při {HintPathFromItem} je určena v SearchPaths parametr.Výchozí hodnota je prázdný řetězec.

  • SpecificVersion: Boolean value.Pokud true, pak přesný název zadaný v Include atributu musí odpovídat.Pokud false, pak bude pracovat libovolné sestavení se stejným názvem, který je jednoduchý.Pokud SpecificVersion není určen, pak úkol zkoumá hodnotu v Include atributu položky.Pokud je atribut jednoduchý název, chová se jako SpecificVersion byla false.Pokud je atribut silného názvu, chová se jako SpecificVersion byla true.

    Při použití položky Typ odkazu, Include atributu musí být úplné syntézy název sestavení, které má být vyřešen.Sestavení vyřešen pouze pokud syntézy přesně odpovídá Include atributu.

    Když cílů projektu.NET Framework verze a odkazy na sestavení sestavit pro a vyšší.NET Framework verze odkaz řeší pouze pokud má SpecificVersion nastavena na true.

    Projekt zaměřuje profil a odkazuje na sestavení, která není v profilu, řeší odkaz pouze pokud má SpecificVersion nastavena na true.

  • ExecutableExtension: String value.Pokud je přítomen, musí být vyřešen sestavení tohoto rozšíření.Při nepřítomnosti, DLL se považuje za první, následovaný exe pro každý adresář zkontrolován.

  • SubType: String value.Pouze položky s metadaty prázdné podtyp budou vyřešeny na sestavení úplné cesty.Položky s metadaty neprázdný podtypu jsou ignorovány.

  • AssemblyFolderKey: String value.Tato metadata je podporován pro starší účely.Určuje klíč registru definované uživatelem, například "hklm\VendorFolder", že Assemblies , používejte vyřešit odkazy na sestavení.

AssemblyFiles

Volitelný ITaskItem[] parametr.

Určuje seznam úplný sestavení, pro který chcete najít závislostí.

Položky předán tento parametr může mít volitelně metadata následující položky:

  • Private: volitelným Boolean hodnotu.Pokud je hodnota true, bude položka zkopírována místně.

  • FusionName: volitelný String metadat.Určuje název jednoduchého nebo silné pro tuto položku.Pokud tento atribut je k dispozici, můžete ušetřit čas, protože není nutné otevřít získat název souboru sestavení.

AutoUnify

Volitelný Boolean parametr.

Pokud true, výsledný graf závislosti automaticky zachází jako kdyby soubor App.Config předán parametr parametr AppConfigFile.Tento virtuální soubor App.Config má bindingRedirect položku pro každou konfliktní nastavení sestavení tak, aby se zvolí nejvyšší verze sestavení.Výsledek toho je, že nikdy bude upozornění o konfliktní sestavení protože bude každý konflikt byl vyřešen.Každý odlišné přemapování způsobí komentář s vysokou prioritou, který označuje staré a nové verze a skutečnost, že důvodem bylo automaticky protože AutoUnify byla true.

Pokud false, žádné přemapování verze sestavení dojde automaticky.Pokud jsou k dispozici dvě verze sestavení bude varování.Každý odlišné konflikt mezi různé verze téhož sestavení způsobí komentář s vysokou prioritou.Po tyto komentáře jsou zobrazeny, bude jediné upozornění s chybou jedinečný kód a text, který čte "nalezen konflikty mezi různými verzemi odkaz a závislá sestavení".

Výchozí hodnota je false.

CandidateAssemblyFiles

Volitelný String[] parametr.

Určuje seznam sestavení pro proces vyhledávání a rozlišení.Hodnoty předán tento parametr musí být absolutní názvy nebo názvy souborů projektu relativní.

Sestavení v tomto seznamu budou zvažovány při SearchPaths parametr obsahuje {CandidateAssemblyFiles} jako jedna z cest zvážit.

CopyLocalDependenciesWhenParentReferenceInGac

Volitelný [Boolean] parametr.

Pokud je hodnota true, zjistit závislost by nakopírovány místně, jedna z kontrol v je-li nadřazený odkaz v souboru projektu obsahuje metadata soukromého nastavit.Je-li nastavit hodnotu soukromé slouží jako závislost.

Pokud není nastaven metadata, závislost přejde přes stejné kontroly jako nadřazený odkaz.Jedním z těchto kontrol je zobrazit, pokud je odkaz v mezipaměti GAC.Pokud odkaz v mezipaměti GAC, pak není zkopírováním místně, protože se předpokládá v GAC v cílovém počítači.To platí pouze pro konkrétní reference a není jeho závislosti.

Například odkaz v souboru projektu, který je v modulu GAC nezkopírují místně, ale jeho závislosti se zkopírují místně, protože nejsou v mezipaměti GAC.

Pokud je hodnota false, odkazuje na soubor projektu jsou kontrolovány a zjistěte, zda jsou v mezipaměti GAC a zkopírují místně příslušný.

Závislosti jsou kontrolovány zobrazíte, pokud jsou v mezipaměti GAC a také zkontrolovány Pokud nadřazený odkaz ze souboru projektu je v modulu GAC.

Pokud nadřazený odkaz ze souboru projektu je v modulu GAC, závislost není kopírován místně.

Zda je tento parametr hodnotu true nebo false, pokud existuje více odkazů nadřazeného a žádný z nich nejsou v mezipaměti GAC, pak je všechny zkopírují místně.

CopyLocalFiles

Volitelný ITaskItem[] jen pro čtení výstupní parametr.

Každý soubor v vrátí ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles, a ScatterFiles parametry, které má CopyLocal metadata položky s hodnotou true.

FilesWritten

Volitelný ITaskItem[] výstupní parametr.

Obsahuje položky, které jsou zapsány na disk.

FindDependencies

Volitelný Boolean parametr.

Pokud true, budou nalezeny závislostí.Jinak se nacházejí pouze primární odkazy.Výchozí hodnota je true.

FindRelatedFiles

Volitelný Boolean parametr.

Pokud true, související soubory, například PDB soubory a soubory XML.Výchozí hodnota je true.

FindSatellites

Volitelný Boolean parametr.

Pokud true, nebude nalezen satelitní sestavení.Výchozí hodnota jetrue.

FindSerializationAssemblies

Volitelný Boolean parametr.

Pokud true, pak úkol hledá sestavení serializace.Výchozí hodnota je true.

FullFrameworkAssemblyTables

Volitelný ITaskItem[] parametr.

Určuje položky, které mají "FrameworkDirectory" metadata redist seznamu přidružit rámec určitého adresáře.Pokud není přidružení bude zaznamenána chyba.Logika vyřešit sestavení odkaz (RAR) používá rámec cílový adresář, pokud není nastaven FrameworkDirectory..

FullFrameworkFolders

Volitelný [String][] parametr.

Určuje sadu složek, které obsahují adresář RedistList.Tento adresář představuje úplné rámec pro daného klienta profilu, například %programfiles%\reference assemblies\microsoft\framework\v4.0.

FullTargetFrameworkSubsetNames

Volitelný String[] parametr.

Obsahuje seznam cílových názvů, dílčí framework.Pokud v seznamu název podsady shoduje v TargetFrameworkSubset název vlastnosti, pak systém vylučuje Tato podmnožina konkrétní cílový rámec sestavení.

IgnoreDefaultInstalledAssemblyTables

Volitelný Boolean parametr.

Pokud true, pak úkol vyhledává a používá další instalaci sestavení tabulky (nebo "Redist uvádí"), se nacházejí v adresáři \RedistList ve TargetFrameworkDirectories.Výchozí hodnota jefalse.

IgnoreDefaultInstalledAssemblySubsetTables

Volitelný Boolean parametr.

Pokud true, pak úloha vyhledává a používá další instalaci sestavení dílčí tabulky (nebo "Dílčí seznam"), se nacházejí v adresáři \SubsetList ve TargetFrameworkDirectories.Výchozí hodnota jefalse.

InstalledAssemblySubsetTables

Volitelný ITaskItem[] parametr.

Obsahuje seznam souborů XML, které určuje sestavení, které by měly být v dílčí cíle.

Jako možnost, položky v seznamu můžete určit metadata "FrameworkDirectory" přidružitInstalledAssemblySubsetTable

s konkrétní rámec adresář.

Pokud existuje pouze jedno TargetFrameworkDirectories prvek a klepněte na položky v seznamu, které postrádají metadata "FrameworkDirectory" je zpracován jako jsou nastavena jedinečná hodnota, který je předán do TargetFrameworkDirectories.

InstalledAssemblyTables

Volitelný String parametr.

Obsahuje seznam souborů XML, které určují sestavení, které se očekává v cílovém počítači nainstalována.

Při InstalledAssemblyTables je nastavena, starší verze sestavení seznamu jsou sloučeny do novější verze, které jsou uvedeny v souboru XML.Také sestavení, které mají nastaven na hodnotu InGAC = "true" jsou považovány za požadavky a jsou nastaveny na CopyLocal = 'false', pokud nejsou výslovně přepsány.

Jako možnost, položky v seznamu můžete určit metadata "FrameworkDirectory" přidružit InstalledAssemblyTable s rámec určitého adresáře.Toto nastavení je ignorováno, pokud název Redist začíná

"Microsoft-Windows-CLRCoreComp".

Pokud existuje pouze jedno TargetFrameworkDirectories prvek a klepněte na položky v seznamu, které postrádají metadata "FrameworkDirectory" jsou zpracovány jako, pokud jsou nastavena jedinečná hodnota, který je předán

to TargetFrameworkDirectories.

LatestTargetFrameworkDirectories

Volitelný String[] parametr.

Určuje seznam adresářů, které obsahují seznamy redist pro aktuální rámec, který lze směrovat na počítači.Pokud není toto nastavení se používá nejvyšší framework nainstalovaných v počítači pro identifikátor dané cílové rámce.

ProfileName

Volitelný [String] parametr.

  • Určuje název profilu framework zaměřeny.Například klienta, webové nebo sítě.

RelatedFiles

Volitelný ITaskItem[] jen pro čtení výstupní parametr.

Obsahuje související soubory, jako například XML a PDB soubory, které mají stejné základní název jako odkaz.

Soubory uvedené v tomto parametru může nepovinně obsahovat následující metadata položky:

  • Primary: Boolean value.Pokud true, pak položky souboru byl předán do pole podle použití Assemblies parametr.Výchozí hodnota je false.

  • CopyLocal: Boolean value.Označuje, zda má daný odkaz zkopírovat výstupní adresář.

ResolvedDependencyFiles

Volitelný ITaskItem[] jen pro čtení výstupní parametr.

Obsahuje nth cesty pořadí závislostí.Tento parametr neobsahuje první objednávky primární odkazy, které jsou obsaženy v ResolvedFiles parametr.

Položky v tomto parametru nepovinně obsahovat následující metadata položky:

  • CopyLocal: Boolean value.Označuje, zda má daný odkaz zkopírovat výstupní adresář.

  • FusionName: String value.Určuje název pro tuto závislost.

  • ResolvedFrom: String value.Určuje přesné hledání cesty, která byla přeloženy z tohoto souboru.

ResolvedFiles

Volitelný ITaskItem[] jen pro čtení výstupní parametr.

Obsahuje seznam všech primární odkazy na úplné cesty.

Položky v tomto parametru nepovinně obsahovat následující metadata položky:

  • CopyLocal: Boolean value.Označuje, zda má daný odkaz zkopírovat výstupní adresář.

  • FusionName: String value.Určuje název pro tuto závislost.

  • ResolvedFrom: String value.Určuje přesné hledání cesty, která byla přeloženy z tohoto souboru.

SatelliteFiles

Volitelný ITaskItem[] jen pro čtení výstupní parametr.

Určuje soubory satelitní nalezen.Budou tyto CopyLocal = true, pokud je odkaz nebo závislost, která způsobila tuto položku existuje CopyLocal = true.

Položky v tomto parametru nepovinně obsahovat následující metadata položky:

  • CopyLocal: Boolean value.Označuje, zda má daný odkaz zkopírovat výstupní adresář.Tato hodnota je true Pokud má odkaz nebo závislost, která způsobila tuto položku existuje CopyLocal hodnotu true.

  • DestinationSubDirectory: String value.Určuje relativní cílového adresáře zkopírujte tuto položku.

ScatterFiles

Volitelný ITaskItem[] jen pro čtení výstupní parametr.

Obsahuje soubory bodový přidružené k jedné dané sestavení.

Položky v tomto parametru nepovinně obsahovat následující metadata položky:

  • CopyLocal: Boolean value.Označuje, zda má daný odkaz zkopírovat výstupní adresář.

SearchPaths

Požadované String[] parametr.

Určuje zvláštní místa, které jsou prohledávány najít soubory na disku, které představují sestavení nebo adresáře.Důležité je pořadí, ve kterém jsou uvedeny cesty pro hledání.Pro každý sestavení seznamu cest prohledány zleva doprava.Po nalezení souboru, který představuje sestavení, hledání zastaví a hledat další spuštění sestavení.

Tento parametr přijímá následující typy hodnot:

  • Cesta k adresáři.

  • {HintPathFromItem}: Určuje, že úloha přezkoumá HintPath metadata základní položku.

  • {CandidateAssemblyFiles}: Určuje, že úkol přezkoumá soubory prošla v CandidateAssemblyFiles parametr.

  • {Registru: _AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}:

  • {AssemblyFolders}: Určuje úkolu budou používat schéma Visual Studio.NET 2003 hledání sestavení z registru.

  • {GAC}: Určuje úkolu budou hledat v mezipaměti GAC.

  • {RawFileName}: Určuje úlohu zváží Include hodnotu přesnou cestu a název položky.

SerializationAssemblyFiles

Volitelný ITaskItem[] jen pro čtení výstupní parametr.

Obsahuje nejsou nalezeny žádné sestavení serializace XML.Tyto položky jsou označeny CopyLocal = true, pokud a jen pokud je odkaz nebo závislost, která způsobila tuto položku existuje CopyLocal = true.

Boolean Metadata CopyLocal označuje, zda má daný odkaz zkopírovat výstupní adresář.

Silent

Volitelný Boolean parametr.

Pokud true, jsou zaznamenány žádné zprávy.Výchozí hodnota je false.

StateFile

Volitelný String parametr.

Určuje název souboru, který označuje, kam chcete uložit mezilehlých sestavit stavu tohoto úkolu.

SuggestedRedirects

Volitelný ITaskItem[] jen pro čtení výstupní parametr.

Obsahuje jednu položku pro každé samostatné konfliktní identity sestavení, bez ohledu na hodnotu AutoUnify parametr.Zahrnuje všechny kultury a PKT, který byl nalezen a není vhodné bindingRedirect položky konfiguračního souboru aplikace.

Každá položka obsahuje také následující informace:

  • IncludeAtribut: obsahuje úplný název sestavení řady verze pole hodnota 0.0.0.0

  • MaxVersionmetadata položky: obsahuje maximální číslo verze.

TargetedRuntimeVersion

Volitelný String parametr.

Určuje verzi modulu runtime na cíl, například 2.0.57027 nebo v2.0.57027.

TargetFrameworkDirectories

Volitelný String[] parametr.

Určuje cestu k adresáři cílový rámec.Tento parametr je nutný stav CopyLocal výsledné položky.

Pokud tento parametr není zadán, žádné výsledné položky bude mít hodnotu CopyLocal true Pokud není výslovně Private hodnotu metadat true na jejich položky zdroje.

TargetFrameworkMoniker

Volitelný String parametr.

TargetFrameworkMoniker sledování, pokud existuje.Používá se pro protokolování.

TargetFrameworkMonikerDisplayName

Volitelný String parametr.

Zobrazovaný název TargetFrameworkMoniker, sledování, pokud existuje.Používá se pro protokolování.

TargetFrameworkSubsets

Volitelný String[] parametr.

Obsahuje seznam cílových názvů, dílčí rámec hledání v adresářích cílový rámec.

TargetFrameworkVersion

Volitelný String parametr.

Verze projektu cílový rámec.Výchozí hodnota je prázdný, což znamená, že je bez filtrování odkazy založené na cílový rámec.

TargetProcessorArchitecture

Volitelný String parametr.

Architektura procesoru upřednostňovaný cíl.Použít pro řešení odkazů v globální mezipaměti sestavení (GAC).

Tento parametr může mít hodnotu x86, IA64 nebo AMD64.

Tento parametr je nepřítomen, úkol nejprve považuje za sestavení, které odpovídají architektura aktuálně spuštěný proces.Je-li nalezen žádný sestavení, úkol za sestavení v mezipaměti GAC, jejichž ProcessorArchitecture hodnotu MSIL nebo ProcessorArchitecture hodnotu.

Poznámky

Vedle výše uvedených parametrů, zdědí tento úkol parametry z TaskExtension dědí třídu, která sama Task třídy.Seznam těchto další parametry a jejich popis naleznete v TaskExtension – základní třída.

Viz také

Koncepty

Úlohy nástroje MSBuild

Další zdroje

Referenční dokumentace úlohy nástroje MSBuild