Udostępnij za pośrednictwem

ResolveAssemblyReference — Zadanie

  • Artykuł

Określa wszystkie zespoły, które zależą od określonych zestawów.Obejmuje to drugi i nzamówienia th zależności.

Parametry

W poniższej tabeli opisano parametry ResolveAssemblyReference zadania.

Parametr

Opis

AllowedAssemblyExtensions

Opcjonalny String[] parametru.

Zgromadzenie rozszerzeń nazw plików do użycia podczas rozpoznawania odniesienia.Domyślnych rozszerzeń nazw plików są .exe i .dll.

AllowedRelatedFileExtensions

Opcjonalny String[] parametru.

Rozszerzenia nazw plików służących do wyszukiwania plików, które są ze sobą powiązane.Domyślnymi rozszerzeniami są .pdb i .xml.

AppConfigFile

Opcjonalny String parametru.

Określa plik app.config, z którego przeanalizować i wyodrębnić bindingRedirect mapowania.Jeśli ten parametr jest określony, AutoUnify parametr musi być false.

AutoUnify

Opcjonalny Boolean parametru.

Ten parametr jest używany do tworzenia zestawów, takich jak biblioteki DLL, które nie mogą mieć normalnej pliku App.Config.

Gdy true, wynikowego wykresu zależność jest automatycznie traktowane, tak jakby anApp.Config pliku przekazanego do parametru AppConfigFile.Ten plik wirtualny App.Config ma wpis bindingRedirect dla każdego zestawu sprzecznych zestawów takie, że jest wybrany najwyższy zestawu wersji.Skutkiem tego jest, że nigdy nie będzie ostrzeżenie dotyczące zestawów powodujące konflikt, ponieważ każdy konflikt będzie został rozwiązany.

Gdy true, każdego mapowania distinct spowoduje komentarz o wysokim priorytecie, wykazujące starej i nowej wersji i że AutoUnify został true.

Gdy true, parametr AppConfigFile musi być pusty

Gdy false, nie mapowania wersja zestawu nastąpi automatycznie.Gdy istnieją dwie wersje asemblowania jest wyświetlane ostrzeżenie.

Gdy false, każdy odrębne konflikt między różnymi wersjami w wyniku zgromadzenia w komentarz o wysokim priorytecie.Uwagi te następują jednego ostrzeżenia.Ostrzeżenie jest jednoznacznym kodem błędu i zawiera tekst, który czyta "Znaleziono konflikty między różnymi wersjami odniesienia i zestawy zależne".

Assemblies

Opcjonalny ITaskItem[] parametru.

Określa elementy, dla których muszą być identyfikowane pełne ścieżki i zależności.Te elementy można mieć prosty nazwy takie jak "System" albo silnych nazw, takich jak "System, wersja = 2.0.3500.0, Culture = neutral, PublicKeyToken = b77a5c561934e089."

Elementy przekazywane do tego parametru opcjonalnie może mieć następujące metadane elementu:

  • Private: Boolean value.Jeśli true, a następnie element jest kopiowane lokalnie.Wartością domyślną jest true.

  • HintPath: String value.Określa ścieżkę i nazwę pliku do używany jako odwołanie.To jest używany, gdy {HintPathFromItem} jest określona w SearchPaths parametru.Wartością domyślną jest ciągiem pustym.

  • SpecificVersion: Boolean value.Jeśli true, a następnie dokładna nazwa określona w Include atrybutu musi odpowiadać.Jeśli false, a następnie każdy zespół o tej samej nazwie proste będzie działać.Jeśli SpecificVersion nie jest określony, a następnie zadanie sprawdza, czy wartość w Include atrybutu element.Jeśli atrybut jest prosta nazwa, zachowuje się tak, jakby SpecificVersion został false.Jeśli atrybut jest silna nazwa, zachowuje się tak, jakby SpecificVersion został true.

    Gdy używana z typem elementu odwołania Include atrybutu musi mieć nazwę syntezy pełnego zestawu jest rozpoznawana jako.Zgromadzenie jest rozwiązane tylko jeśli syntezy dokładnie odpowiada Include atrybut.

    Kiedy cele projektu.NET Framework w wersji i odwołania do zestawu są kompilowane za wyższy.NET Framework w wersji odniesienia rozpoznaje tylko jeśli ma SpecificVersion ustawiona na true.

    Gdy projekt profil jest przeznaczony i odwołuje się do zestawu, który nie jest w profilu, odwołanie rozwiązuje tylko jeśli ma SpecificVersion ustawiona na true.

  • ExecutableExtension: String value.Jeśli jest obecny, rozpoznać zestawu musi mieć rozszerzenie.Podczas nieobecności, .dll jest uwzględniane w pierwszej kolejności, następuje .exe, dla każdego badanego katalogu.

  • SubType: String value.Tylko elementy z metadanymi podtypu puste zostaną rozwiązane do pełnego zestawu ścieżek.Elementy z niepusty podtyp metadane są ignorowane.

  • AssemblyFolderKey: String value.Metadanych jest obsługiwana dla celów starszego typu.Określa klucz rejestru zdefiniowane przez użytkownika, takie jak "hklm\VendorFolder", że Assemblies należy użyć, aby rozpoznać odwołania do zestawów.

AssemblyFiles

Opcjonalny ITaskItem[] parametru.

Określa listę zestawów pełną dla której będą wyszukiwane zależności.

Elementy przekazywane do tego parametru opcjonalnie może mieć następujące metadane elementu:

  • Private: opcjonalny Boolean wartości.Jeśli wartość true, element jest kopiowane lokalnie.

  • FusionName: opcjonalny String metadanych.Określa nazwę proste lub silne dla tego elementu.Jeśli ten atrybut jest obecny, można zaoszczędzić czas, ponieważ nie ma zostać otwarty, aby uzyskać nazwę pliku zestawu.

AutoUnify

Opcjonalny Boolean parametru.

Jeśli true, wynikowego wykresu zależność jest automatycznie traktowana jak gdyby pliku App.Config przekazanego do parametru AppConfigFile.Ten plik wirtualny App.Config ma wpis bindingRedirect dla każdego zestawu sprzecznych zestawów tak, że wybierany jest najwyższym zestawu wersji.Rezultatem tego jest, że nigdy nie będzie ostrzeżenie dotyczące zestawów powodujące konflikt, ponieważ każdy konflikt będzie został rozwiązany.Każdego mapowania distinct spowoduje, że komentarz o wysokim priorytecie, który wskazuje starej i nowej wersji i fakt, że zrobiono to automatycznie ponieważ AutoUnify został true.

Jeśli false, nie mapowania wersja zestawu nastąpi automatycznie.Gdy istnieją dwie wersje zespół będzie się ostrzeżenie.Każdy odrębne konflikt między różnymi wersjami tego samego zestawu spowoduje, że komentarz o wysokim priorytecie.Po te komentarze są wyświetlane, będzie istnieć jednego ostrzeżenia z błędem unikatowy kod i tekst, który czyta "znaleziono konflikty między różnymi wersjami odniesienia i zestawy zależne".

Wartością domyślną jest false.

CandidateAssemblyFiles

Opcjonalny String[] parametru.

Określa listę zestawów używanych w procesie wyszukiwania i rozdzielczość.Wartości przekazanych do tego parametru musi być bezwzględna pliku nazwy lub nazwy pliku projektu względne.

Zestawy na tej liście będą rozważane podczas SearchPaths parametr zawiera {CandidateAssemblyFiles} jako jedna ze ścieżek do rozważenia.

CopyLocalDependenciesWhenParentReferenceInGac

Opcjonalny [Boolean] parametru.

Jeśli wartość true, czy zależność powinny zostać skopiowane lokalnie, jedna z kontroli Sporządzono został czy odwołanie nadrzędne w pliku projektu ma metadanych prywatnego ustawić.Jeśli zestaw, a następnie prywatnych wartość jest używana jako zależność.

Jeśli nie ustawiono metadanych, zależność przechodzi przez takie same kontrole jako odwołanie nadrzędnej.Jednym z tych kontroli jest czy odwołanie znajduje się w pamięci podręcznej GAC.Jeśli odwołanie znajduje się w pamięci podręcznej GAC, następnie go nie jest kopiowane lokalnie, ponieważ zakłada się w pamięci podręcznej GAC na komputerze docelowym.Stosuje się tylko do określonego odniesienia i nie jego zależności.

Na przykład odwołanie w pliku projektu, który znajduje się w pamięci podręcznej GAC nie zostaną skopiowane lokalnie, ale jego zależności są kopiowane lokalnie, ponieważ nie są one w pamięci podręcznej GAC.

Jeśli ma wartość FAŁSZ, odwołania do pliku projektu są sprawdzane Aby sprawdzić, czy znajdują się w pamięci podręcznej GAC i są kopiowane lokalnie, jak właściwe.

Zależności są sprawdzane w celu sprawdzenia, czy są one w pamięci podręcznej GAC i również są sprawdzane, czy odwołanie nadrzędnej z pliku projektu jest w pamięci podręcznej GAC.

Jeśli odwołanie nadrzędnej z pliku projektu jest w pamięci podręcznej GAC, zależność nie jest kopiowane lokalnie.

Czy ten parametr ma wartość PRAWDA lub FAŁSZ, jeśli istnieje wiele odwołań nadrzędnego i żadnego z nich nie znajdują się w pamięci podręcznej GAC, następnie wszystkie z nich są kopiowane lokalnie.

CopyLocalFiles

Opcjonalny ITaskItem[] parametr wyjściowy tylko do odczytu.

Zwraca każdy plik w ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles, i ScatterFiles parametry, które ma CopyLocal elementu metadanych z wartością true.

FilesWritten

Opcjonalny ITaskItem[] parametr wyjścia.

Zawiera elementy zapisane na dysku.

FindDependencies

Opcjonalny Boolean parametru.

Jeśli true, będzie można znaleźć zależności.W przeciwnym razie zostaną znalezione tylko odwołania podstawowego.Wartością domyślną jest true.

FindRelatedFiles

Opcjonalny Boolean parametru.

Jeśli true, związanych z znajdują się pliki, takie jak pliki .pdb i pliki XML.Wartością domyślną jest true.

FindSatellites

Opcjonalny Boolean parametru.

Jeśli true, zestawy zostanie znaleziona.Wartością domyślną jesttrue.

FindSerializationAssemblies

Opcjonalny Boolean parametru.

Jeśli true, następnie zadanie szuka zestawów serializacji.Wartością domyślną jest true.

FullFrameworkAssemblyTables

Opcjonalny ITaskItem[] parametru.

Określa elementy, które mają metadanych "FrameworkDirectory" Aby skojarzyć listy redist z katalogu określonego ramy.Jeśli skojarzenie nie zostanie zrealizowana, błąd zostanie zarejestrowany.Logika odniesienia (RAR) zgromadzenia Rozwiąż używa katalog docelowy w ramach, jeśli FrameworkDirectory nie jest ustawiona.

FullFrameworkFolders

Opcjonalny [String][] parametru.

Określa zestaw folderów, które zawierają katalog RedistList.Katalog ten reprezentuje pełną ramy dla profilu danego klienta, na przykład, %programfiles%\reference assemblies\microsoft\framework\v4.0.

FullTargetFrameworkSubsetNames

Opcjonalny String[] parametru.

Zawiera listę nazw podzbiór ramy docelowych.Jeśli nazwa podzbioru na liście pasuje do w TargetFrameworkSubset nazwę właściwości, a następnie system wyłącza podzbiór ramy określonego elementu docelowego w czasie kompilacji.

IgnoreDefaultInstalledAssemblyTables

Opcjonalny Boolean parametru.

Jeśli true, następnie szuka zadania i zastosowania dodatkowych zainstalowany zestaw tabel (lub "Wyświetla Redist") znajdują się w katalogu \RedistList TargetFrameworkDirectories.Wartością domyślną jestfalse.

IgnoreDefaultInstalledAssemblySubsetTables

Opcjonalny Boolean parametru.

Jeśli true, następnie szuka zadania i zastosowania dodatkowych zainstalowany zestawu tabel podzbiór (lub "Wyświetla podzbiór") znajdują się w katalogu \SubsetList TargetFrameworkDirectories.Wartością domyślną jestfalse.

InstalledAssemblySubsetTables

Opcjonalny ITaskItem[] parametru.

Zawiera listę plików XML, które określają zestawy, które są przewidywane do podzbioru docelowych.

Jako opcja elementy z tej listy można określić metadanych "FrameworkDirectory", aby skojarzyćInstalledAssemblySubsetTable

z katalogu określonego ramy.

Jeśli istnieje tylko jeden TargetFrameworkDirectories element, a następnie wszystkie elementy na tej liście, których brakuje metadanych "FrameworkDirectory" są traktowane tak, jakby są ustawione na unikatową wartość, która jest przekazywana do TargetFrameworkDirectories.

InstalledAssemblyTables

Opcjonalny String parametru.

Zawiera listę plików XML, które określają zestawy, które mają być zainstalowane na komputerze docelowym.

Gdy InstalledAssemblyTables jest ustawianie starszych zestawów na liście są scalane w nowsze wersje, które są wymienione w pliku XML.Również, zestawów, które jest dostępne ustawienie InGAC = "true" są traktowane jako wymagania wstępne i są ustawione na CopyLocal = 'false', chyba że zostały one jednoznacznie zastąpione.

Jako opcja elementy z tej listy można określić metadanych "FrameworkDirectory", aby skojarzyć InstalledAssemblyTable z katalogu określonego ramy.Jednak to ustawienie jest ignorowane, chyba że zaczyna się od nazwy Redist

"Microsoft-Windows-CLRCoreComp".

Jeśli istnieje tylko jeden TargetFrameworkDirectories element, a następnie wszystkie elementy na tej liście, których brakuje metadanych "FrameworkDirectory" są traktowane tak, jakby są ustawione na unikatową wartość, która jest przekazywana

to TargetFrameworkDirectories.

LatestTargetFrameworkDirectories

Opcjonalny String[] parametru.

Określa listę katalogów, które zawierają listy redist ramy najbardziej aktualne można ukierunkowane na komputerze.Jeśli nie jest ustawiony najwyższy framework zainstalowana na komputerze dla identyfikatora ram określonej wartości docelowej jest używany.

ProfileName

Opcjonalny [String] parametru.

  • Określa nazwę profilu ramy do docelowych.Na przykład klient, sieci Web lub sieci.

RelatedFiles

Opcjonalny ITaskItem[] parametr wyjściowy tylko do odczytu.

Zawiera pliki powiązane, takie jak pliki XML i .pdb, które mają tę samą nazwę bazową jako odwołanie.

Pliki wymienione w tym parametrze opcjonalnie może zawierać następujące metadane elementu:

  • Primary: Boolean value.Jeśli true, a następnie element plik został przekazany do tablicy przez za pomocą Assemblies parametru.Wartością domyślną jest false.

  • CopyLocal: Boolean value.Wskazuje, czy danego odwołania powinny zostać skopiowane do katalogu dane wyjściowe.

ResolvedDependencyFiles

Opcjonalny ITaskItem[] parametr wyjściowy tylko do odczytu.

Zawiera nth kolejności ścieżek do zależności między zadaniami.Parametr ten nie obejmuje pierwszy podstawowy odwołania do zlecenia, które są zawarte w ResolvedFiles parametru.

Elementy w tym parametrze opcjonalnie zawierają następujące metadane elementu:

  • CopyLocal: Boolean value.Wskazuje, czy danego odwołania powinny zostać skopiowane do katalogu dane wyjściowe.

  • FusionName: String value.Określa nazwę tej zależności.

  • ResolvedFrom: String value.Określa ścieżkę wyszukiwania dosłownego, że plik ten został rozwiązany z.

ResolvedFiles

Opcjonalny ITaskItem[] parametr wyjściowy tylko do odczytu.

Zawiera listę wszystkich odwołań do podstawowego zdecydowane pełne ścieżki.

Elementy w tym parametrze opcjonalnie zawierają następujące metadane elementu:

  • CopyLocal: Boolean value.Wskazuje, czy danego odwołania powinny zostać skopiowane do katalogu dane wyjściowe.

  • FusionName: String value.Określa nazwę tej zależności.

  • ResolvedFrom: String value.Określa ścieżkę wyszukiwania dosłownego, że plik ten został rozwiązany z.

SatelliteFiles

Opcjonalny ITaskItem[] parametr wyjściowy tylko do odczytu.

Określa wszelkie pliki satelitarnej znalezione.Będą one CopyLocal = true, jeśli odwołanie lub zależność, która spowodowała tego elementu istnieje CopyLocal = true.

Elementy w tym parametrze opcjonalnie zawierają następujące metadane elementu:

  • CopyLocal: Boolean value.Wskazuje, czy danego odwołania powinny zostać skopiowane do katalogu dane wyjściowe.Ta wartość jest true Jeśli odniesienia lub zależność, która spowodowała tego elementu istnieje ma CopyLocal wartość true.

  • DestinationSubDirectory: String value.Określa katalog docelowy względne do skopiowania tego elementu do.

ScatterFiles

Opcjonalny ITaskItem[] parametr wyjściowy tylko do odczytu.

Zawiera pliki punktowego skojarzonych z jednym z danym zestawów.

Elementy w tym parametrze opcjonalnie zawierają następujące metadane elementu:

  • CopyLocal: Boolean value.Wskazuje, czy danego odwołania powinny zostać skopiowane do katalogu dane wyjściowe.

SearchPaths

Wymagane String[] parametru.

Określa katalogi lub specjalne lokalizacje, które są przeszukiwane, aby znaleźć pliki na dysku, które reprezentują zgromadzeń.Ważne jest kolejność, w jakiej są wyświetlane ścieżki wyszukiwania.Dla każdego zestawu listy ścieżek jest przeszukiwany od lewej do prawej.Po znalezieniu pliku, która reprezentuje zestaw przeszukujące zatrzymuje i poszukiwanie następnego uruchamiania zestawu.

Ten parametr akceptuje następujące typy wartości:

  • Ścieżka katalogu.

  • {HintPathFromItem}: Określa, że zbada zadania HintPath metadanych elementu bazowego.

  • {CandidateAssemblyFiles}: Określa, że zadanie zbada pliki przeszła w CandidateAssemblyFiles parametru.

  • {Rejestru: _AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}:

  • {AssemblyFolders}: określa zadania będą używać programu Visual Studio.NET 2003 znajdowanie zespołów z rejestru.

  • {GAC}: Określa zadanie będzie przeszukiwać w pamięci podręcznej GAC.

  • {RawFileName}: określa zadania będą rozważać Include wartość zapasu do dokładną ścieżkę i nazwę.

SerializationAssemblyFiles

Opcjonalny ITaskItem[] parametr wyjściowy tylko do odczytu.

Zawiera wszelkie zestawów serializacji XML znaleźć.Te elementy są oznaczone CopyLocal = true, jeśli i tylko wtedy, gdy odwołanie lub zależność, która spowodowała tego elementu istnieje CopyLocal = true.

Boolean Metadanych CopyLocal wskazuje, czy danego odwołania powinny zostać skopiowane do katalogu dane wyjściowe.

Silent

Opcjonalny Boolean parametru.

Jeśli true, są rejestrowane żadne komunikaty.Wartością domyślną jest false.

StateFile

Opcjonalny String parametru.

Określa nazwę pliku, który wskazuje, gdzie zapisać pośredniego zbudować stanu dla tego zadania.

SuggestedRedirects

Opcjonalny ITaskItem[] parametr wyjściowy tylko do odczytu.

Zawiera jeden element dla każdego odrębne sprzecznych tożsamości zestawu, niezależnie od wartości AutoUnify parametru.Obejmuje to, co kultury i PKT został znaleziony, który nie miał bindingRedirect odpowiedni wpis w pliku konfiguracyjnym aplikacji.

Każdy element opcjonalnie zawiera następujące informacje:

  • Includeatrybut: zawiera pełną nazwę rodziny zestawu z wartością pola wersja 0.0.0.0

  • MaxVersionelement metadanych: Maksymalna liczba wersji zawiera.

TargetedRuntimeVersion

Opcjonalny String parametru.

Określa numer wersji środowiska wykonawczego do obiektu docelowego, na przykład 2.0.57027 lub v2.0.57027.

TargetFrameworkDirectories

Opcjonalny String[] parametru.

Określa ścieżkę katalogu docelowego ramy.Ten parametr jest wymagany do określenia statusu CopyLocal wynikowy elementów.

Jeżeli nie określono tego parametru, żadne elementy wynikowy będzie mieć wartość CopyLocal true , chyba że posiadają wyraźnie Private wartości metadanych true na ich element źródłowy.

TargetFrameworkMoniker

Opcjonalny String parametru.

TargetFrameworkMoniker do monitorowania, jeśli istnieje.To jest używana do logowania.

TargetFrameworkMonikerDisplayName

Opcjonalny String parametru.

Wyświetlana nazwa TargetFrameworkMoniker do monitorowania, jeśli istnieje.To jest używana do logowania.

TargetFrameworkSubsets

Opcjonalny String[] parametru.

Zawiera listę nazw podzbiór ramy docelowego mają być wyszukiwane w katalogach ramy docelowych.

TargetFrameworkVersion

Opcjonalny String parametru.

Wersja projektu docelowego ramy.Wartością domyślną jest puste, co oznacza, że istnieje odniesienia, na podstawie ram docelowych nie filtrowania.

TargetProcessorArchitecture

Opcjonalny String parametru.

Architektura procesora preferowany docelowych.Używane do rozpoznawania odniesienia globalnego Assembly Cache (GAC).

Ten parametr może mieć wartość x86, IA64 lub AMD64.

Jeśli ten parametr jest nieobecny, zadanie najpierw uważa zestawy, które odpowiadają architektury aktualnie uruchomiony proces.Jeżeli Zgromadzenie nie zostanie znaleziony, zadanie uważa zestawów w pamięci podręcznej GAC jest ProcessorArchitecture wartość MSIL lub ProcessorArchitecture wartości.

Uwagi

Oprócz parametrów wymienionych powyżej, to zadanie dziedziczy parametry z TaskExtension , które sama klasa dziedziczy z Task klasy.Aby uzyskać listę tych dodatkowych parametrów, a ich opisy, zobacz TaskExtension — Klasa podstawowa.

Zobacz też

Koncepcje

Zadania programu MSBuild

Inne zasoby

Odwołanie do zadania MSBuild