ResolveAssemblyReference-Aufgabe

AllowedAssemblyExtensions

Optionaler String[]-Parameter.

Die beim Auflösen von Verweisen zu verwendenden Dateinamenerweiterungen der Assemblys.Die Standarderweiterungen sind EXE und DLL.

AppConfigFile

Optionaler String-Parameter.

Gibt eine app.config-Datei an, aus der bindingRedirect-Zuordnungen analysiert und extrahiert werden sollen.Wenn dieser Parameter angegeben ist, muss der AutoUnify-Parameter den Wert false haben.

Assemblies

Optionaler ITaskItem[]-Parameter.

Gibt die Elemente an, für die vollständige Pfade und Abhängigkeiten identifiziert werden müssen.Diese Elemente haben einfache Namen wie "System" oder starke Namen wie "System, Version=2 .0.3500.0, Culture=neutral, PublicKeyToken=b77a5c561934e089".

Die an diesen Parameter übergebenen Elemente weisen möglicherweise die folgenden optionalen Elementmetadaten auf:

• Private: Boolean-Wert.Wenn der Wert true ist, wird das Element lokal kopiert.Der Standardwert ist true.

• HintPath: String-Wert.Gibt den Pfad und den Dateinamen an, die als Verweis verwendet werden sollen.Dies wird verwendet, wenn {HintPathFromItem} im SearchPaths-Parameter angegeben ist.Der Standardwert ist eine leere Zeichenfolge ("").

• SpecificVersion: Boolean-Wert.Wenn der Wert true ist, dann muss der genaue im Include-Attribut angegebene Name übereinstimmen.Wenn der Wert false ist, liegt bei jeder Assembly mit dem gleichen einfachen Namen eine Übereinstimmung vor.Wenn SpecificVersion nicht angegeben ist, prüft die Aufgabe den Wert im Include-Attribut des Elements.Wenn das Attribut ein einfacher Name ist, verhält es sich, als ob SpecificVersionfalse wäre.Wenn das Attribut ein starker Name ist, verhält es sich, als ob SpecificVersiontrue wäre.

  Bei Verwendung mit einem Verweiselementtyp muss das Include-Attribut der volle Fusionsname der aufzulösenden Assembly sein.Die Assembly wird nur aufgelöst, wenn Fusion genau dem Include-Attribut entspricht.

  Wenn ein Projekt auf eine .NET Framework-Version abzielt und auf eine Assembly verweist, die für eine höhere .NET Framework-Version kompiliert wurde, wird der Verweis nur aufgelöst, wenn für ihn SpecificVersion auf true festgelegt ist.

  Wenn ein Projekt auf ein Profil abzielt und auf eine Assembly verweist, die nicht im Profil ist, wird der Verweis nur aufgelöst, wenn für ihn SpecificVersion auf true festgelegt ist.

• ExecutableExtension: String-Wert.Wenn vorhanden, muss die aufgelöste Assembly über diese Erweiterung verfügen.Wenn nicht vorhanden, wird bei jedem überprüften Verzeichnis zunächst die DLL-Erweiterung und anschließend die EXE-Erweiterung geprüft.

• SubType: String-Wert.Nur Elemente mit leeren SubType-Metadaten werden in vollständige Assemblypfade aufgelöst.Elemente mit nicht leeren SubType-Metadaten werden ignoriert.

• AssemblyFolderKey: String-Wert.Diese Metadaten werden für Legacyzwecke unterstützt.Sie geben einen benutzerdefinierten Registrierungsschlüssel an, z. B. "hklm \VendorFolder", den Assemblies verwenden sollten, um Assemblyverweise aufzulösen.

AutoUnify

Optionaler Boolean-Parameter.

Wenn true, wird das entsprechende Abhängigkeitsdiagramm automatisch so verarbeitet, als ob eine App.Config-Datei an den AppConfigFile-Parameter übergeben wird.Diese virtuelle App.Config-Datei verfügt über einen bindingRedirect-Eintrag für jede einen Konflikt verursachende Assemblygruppe, sodass jeweils die Assembly mit der höchsten Version ausgewählt wird.Daraus folgt, dass nie eine Warnmeldung über in Konflikt stehende Assemblys ausgegeben wird, da jeder Konflikt bereits gelöst wurde.Jede Neuzuordnung führt zu einem Kommentar höchster Priorität mit Angaben zur alten und neuen Version. Die Zuordnung erfolgt automatisch, da AutoUnifytrue ist.

Wenn false, wird keine automatische Neuzuordnung der Assemblyversion ausgeführt.Wenn zwei Versionen einer Assembly vorliegen, wird eine Warnmeldung ausgegeben.Jeder klare Konflikt zwischen verschiedenen Versionen der gleichen Assembly führt zu einem Kommentar höchster Priorität.Nach der Anzeige aller Kommentare wird eine Warnmeldung mit einem eindeutigen Fehlercode und dem Text "Konflikte zwischen verschiedenen Versionen der Referenzassembly und abhängigen Assembly wurden gefunden" ausgegeben.

Der Standardwert ist false.

CopyLocalDependenciesWhenParentReferenceInGac

Optionaler [Boolean]-Parameter.

Beim Wert true wird, um zu ermitteln, ob eine Abhängigkeit lokal kopiert werden soll, überprüft, ob für den übergeordneten Verweis in der Projektdatei die Private-Metadaten festgelegt wurden oder nicht.Wenn festgelegt, dann wird der private Wert als Abhängigkeit verwendet.

Wenn die Metadaten nicht festgelegt wurden, durchläuft die Abhängigkeit die gleichen Überprüfungen wie der übergeordnete Verweis.Mit einer dieser Überprüfungen wird ermittelt, ob sich der Verweis im GAC befindet.Wenn sich ein Verweis im GAC befindet, ist dann wird er nicht lokal kopiert, da davon ausgegangen wird, dass er im GAC auf dem Zielcomputer ist.Dies gilt nur für einen bestimmten Verweis und nicht für seine Abhängigkeiten.

Beispielsweise wird ein Verweis in der Projektdatei, die sich im GAC befindet, nicht lokal kopiert, aber seine Abhängigkeiten werden lokal kopiert, da sie nicht im GAC befinden.

Wenn false, werden Projektdateiverweise überprüft, um zu sehen, ob sie im GAC sind, und ggf. lokal kopiert.

Abhängigkeiten werden überprüft, um festzustellen, ob sie sich im GAC befinden und werden auch überprüft, um zu sehen, ob sich der übergeordneten Verweis aus der Projektdatei im GAC befindet.

Wenn der übergeordnete Verweis aus der Projektdatei sich im GAC befindet, wird die Abhängigkeit nicht lokal kopiert.

Ob dieser Parameter nun true oder false ist – wenn es mehrere übergeordnete Verweise da sind und einer von ihnen nicht im GAC ist, dann werden alle lokal kopiert.

FilesWritten

Optionaler ITaskItem[]-Ausgabeparameter.

Enthält die auf den Datenträger geschriebenen Elemente.

FindRelatedFiles

Optionaler Boolean-Parameter.

Wenn true, werden verwandte Dateien gefunden, z. B. PDB-Dateien und XML-Dateien.Der Standardwert ist true.

FindSerializationAssemblies

Optionaler Boolean-Parameter.

Wenn der Wert true ist, dann sucht die Aufgabe nach Serialisierungsassemblys.Der Standardwert ist true.

FullFrameworkFolders

Optionaler [String][] -Parameter.

Gibt den Satz von Ordnern an, die ein RedistList-Verzeichnis enthalten.Dieses Verzeichnis stellt die vollständigen Frameworks für ein bestimmtes Clientprofil dar, z. B. %programfiles%\reference assemblies\microsoft\framework\v4.0.

IgnoreDefaultInstalledAssemblyTables

Optionaler Boolean-Parameter.

Wenn der Wert true ist, sucht die Aufgabe nach zusätzlichen installierten Assemblytabellen (oder "REDIST-Listen"), die im \RedistList-Verzeichnis unter TargetFrameworkDirectories gefunden werden, und verwendet diese.Standardwert: false.

InstalledAssemblySubsetTables

Optionaler ITaskItem[]-Parameter.

Enthält eine Liste mit XML-Dateien, die die Assemblys angeben, die sich in der Zielteilmenge befinden sollten.

Als Option können Elemente in dieser Liste die "FrameworkDirectory"-Metadaten angeben, um eine InstalledAssemblySubsetTable

einem bestimmten Frameworkverzeichnis zuzuordnen.

Wenn nur ein TargetFrameworkDirectories-Element vorhanden ist, werden alle Elemente in dieser Liste, die nicht über die "FrameworkDirectory"-Metadaten verfügen, so behandelt, als seien sie auf den eindeutigen Wert festgelegt, der an TargetFrameworkDirectories übergeben wird.

LatestTargetFrameworkDirectories

Optionaler String[]-Parameter.

Gibt eine Liste der Verzeichnisse zurück, die die redist-Listen für das aktuelle Framework enthalten, auf das auf dem Computer abgezielt werden kann.Wenn dies nicht festgelegt wird, wird das höchste auf dem Computer installierte Framework für einen angegebenen Zielframeworkbezeichner verwendet.

RelatedFiles

Optionaler schreibgeschützter ITaskItem[]-Ausgabeparameter.

Enthält verwandte Dateien, z. B. XML-Dateien und PDB-Dateien mit dem gleichen Basisnamen als Verweis.

Die in diesem Parameter aufgelisteten Dateien können die folgenden Elementmetadaten enthalten (optional):

• Primary: Boolean-Wert.Wenn der Wert true ist, dann wurde das Dateielement mit dem Assemblies-Parameter in das Array übergeben.Der Standardwert lautet false.

• CopyLocal: Boolean-Wert.Gibt an, ob der angegebene Verweis in das Ausgabeverzeichnis kopiert werden soll.

ResolvedFiles

Optionaler schreibgeschützter ITaskItem[]-Ausgabeparameter.

Enthält eine Liste aller in vollständige Pfade aufgelöste Primärverweise.

Die Elemente in diesem Parameter können die folgenden Elementmetadaten enthalten (optional):

• CopyLocal: Boolean-Wert.Gibt an, ob der angegebene Verweis in das Ausgabeverzeichnis kopiert werden soll.

• FusionName: String-Wert.Gibt den Namen für diese Abhängigkeit an.

• ResolvedFrom: String-Wert.Gibt den literalen Suchpfad an, aus dem die Datei aufgelöst wurde.

ScatterFiles

Optionaler schreibgeschützter ITaskItem[]-Ausgabeparameter.

Enthält die einer der angegebenen Assemblys zugeordneten Scatter-Dateien.

Die Elemente in diesem Parameter können die folgenden Elementmetadaten enthalten (optional):

• CopyLocal: Boolean-Wert.Gibt an, ob der angegebene Verweis in das Ausgabeverzeichnis kopiert werden soll.

SerializationAssemblyFiles

Optionaler schreibgeschützter ITaskItem[]-Ausgabeparameter.

Enthält alle gefundenen XML-Serialisierungsassemblys.Diese Elemente sind markiert mit CopyLocal=true, wenn und nur wenn der Verweis oder die Abhängigkeit, die die Existenz dieses Elements verursacht, CopyLocal=true ist.

Der Boolean-Metadatenwert CopyLocal gibt an, ob der angegebene Verweis in das Ausgabeverzeichnis kopiert werden soll.

StateFile

Optionaler String-Parameter.

Gibt einen Dateinamen an, mit dem festgelegt wird, an welchem Speicherort der Zwischenbuild für die Aufgabe gespeichert werden soll.

TargetedRuntimeVersion

Optionaler String-Parameter.

Gibt die Zielversion der Laufzeit an, z. B. 2.0.57027 oder v2.0.57027.

TargetFrameworkMoniker

Optionaler String-Parameter.

Der zu überwachende TargetFrameworkMoniker, falls vorhanden.Dies wird für die Protokollierung verwendet.

TargetFrameworkSubsets

Optionaler String[]-Parameter.

Enthält eine Liste der Namen für die Zielframework-Teilmenge, nach der in den Zielframework-Verzeichnissen gesucht werden soll.

TargetProcessorArchitecture

Optionaler String-Parameter.

Die bevorzugte Architektur des Zielprozessors.Wird zum Auflösen von Verweisen auf den globalen Assemblycache (GAC) verwendet.

Dieser Parameter kann den Wert x86, IA64 oder AMD64 aufweisen.

Wenn dieser Parameter nicht vorhanden ist, berücksichtigt die Aufgabe zuerst Assemblys, die der Architektur des derzeit ausgeführten Prozesses entsprechen.Wenn keine Assembly gefunden wird, berücksichtigt die Aufgabe Assemblys im GAC, die den ProcessorArchitecture-Wert MSIL oder keinen ProcessorArchitecture-Wert aufweisen.