ResolveAssemblyReference-Aufgabe

AllowedRelatedFileExtensions

Optionaler String[]-Parameter.

Die für eine Suche nach zusammengehörigen Dateien zu verwendenden Dateinamenerweiterungen. Die Standarderweiterungen sind PDB und XML.

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.

• 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.

CopyLocalFiles

Optionaler schreibgeschützter ITaskItem[]-Ausgabeparameter.

Gibt jede Datei in den Parametern ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles und ScatterFiles zurück, die über CopyLocal-Elementmetadaten mit dem Wert true verfügt.

FindDependencies

Optionaler Boolean-Parameter.

Wenn true, werden Abhängigkeiten gefunden. Andernfalls werden nur Primärverweise gefunden. Der Standardwert ist true.

FindSatellites

Optionaler Boolean-Parameter.

Wenn true, werden Satellitenassemblys gefunden. Der Standardwert ist true..

FullTargetFrameworkSubsetNames

Optionaler String[]-Parameter.

Enthält eine Liste mit Teilmengennamen für das Zielframework. Wenn ein Teilmengenname aus der Liste mit einem in der TargetFrameworkSubset-Namenseigenschaft übereinstimmt, schließt das System diese Zielframework-Teilmenge zur Buildzeit aus.

IgnoreDefaultInstalledAssemblySubsetTables

Optionaler Boolean-Parameter.

Wenn der Wert true ist, sucht die Aufgabe nach zusätzlichen installierten Assemblyteilmengentabellen (oder "Teilmengenlisten"), die im \SubsetList-Verzeichnis unter TargetFrameworkDirectories gefunden werden, und verwendet diese. Der Standardwert ist false.

InstalledAssemblyTables

Optionaler String-Parameter.

Enthält eine Liste mit XML-Dateien, die die Assemblys angeben, die auf dem Zielcomputer installiert werden sollten.

Wenn InstalledAssemblyTables festgelegt ist, werden frühere Versionen der Assemblys in der Liste in neuere Versionen zusammengeführt, die in der XML aufgelistet werden. Außerdem gelten Assemblys mit der Einstellung InGAC='true' als Voraussetzungen und werden auf CopyLocal='false' festgelegt, sofern dies nicht ausdrücklich überschrieben wird.

Als Option können Elemente in dieser Liste die "FrameworkDirectory"-Metadaten angeben, um eine InstalledAssemblyTable einem bestimmten Frameworkverzeichnis zuzuordnen. Diese Einstellung wird jedoch ignoriert, es sei denn, der Redist-Name beginnt mit

"Microsoft-Windows-CLRCoreComp".

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.

ResolvedDependencyFiles

Optionaler schreibgeschützter ITaskItem[]-Ausgabeparameter.

Enthält die Pfade der n-ten Ebene für Abhängigkeiten. Dieser Parameter umfasst keine Primärverweise der ersten Ebene, die im ResolvedFiles-Parameter enthalten sind.

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.

SatelliteFiles

Optionaler schreibgeschützter ITaskItem[]-Ausgabeparameter.

Gibt alle gefundenen Satellitendateien an. Die Dateien sind CopyLocal=true, wenn der Verweis oder die Abhängigkeit für das Vorhandensein des Elements CopyLocal=true ist.

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. Dieser Wert ist true, wenn der Verweis oder die Abhängigkeit für das Vorhandensein des Elements den Wert true für CopyLocal aufweist.

• DestinationSubDirectory: String-Wert. Gibt das relative Zielverzeichnis an, in das das Element kopiert werden soll.

SearchPaths

Erforderlicher String[]-Parameter.

Gibt die Verzeichnisse oder speziellen Speicherorte an, die zum Suchen der Dateien zur Assemblydarstellung auf dem Datenträger durchsucht werden. Die Reihenfolge, in der die Suchpfade aufgeführt sind, ist wichtig. Bei jeder Assembly wird die Liste der Pfade von links nach rechts durchsucht. Wenn eine Datei, die die Assembly darstellt, gefunden wird, wird die entsprechende Suche beendet und die Suche für die nächste Assembly gestartet.

Für diesen Parameter können die folgenden Werttypen angegeben werden:

• Ein Verzeichnispfad.

• {HintPathFromItem}: Gibt an, dass die Aufgabe die HintPath-Metadaten des Basiselements überprüft.

• {CandidateAssemblyFiles}: Gibt an, dass die Aufgabe die mit dem CandidateAssemblyFiles-Parameter übergebenen Dateien überprüft.

• {Registry:_AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}:

• {AssemblyFolders}: Gibt die Aufgabe an, die das Schema von Visual Studio .NET 2003 zum Suchen von Assemblys in der Registrierung verwendet.

• {GAC }: Gibt die Aufgabe an, die den GAC durchsucht.

• {RawFileName}: Gibt die Aufgabe an, die den Include-Wert des Elements als exakten Pfad- und Dateinamen berücksichtigt.

StateFile

Optionaler String-Parameter.

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

TargetFrameworkDirectories

Optionaler String[]-Parameter.

Gibt den Pfad für das Zielframework-Verzeichnis an. Dieser Parameter muss zum Ermitteln des CopyLocal-Status für die resultierenden Elemente angegeben werden.

Wenn dieser Parameter nicht angegeben ist, weisen die resultierenden Elemente nur dann den Wert true für CopyLocal auf, wenn explizit der Private-Metadatenwert true für das zugehörige Quellelement festgelegt wurde.

TargetFrameworkVersion

Optionaler String-Parameter.

Die Zielframeworkversion für das Projekt. Der Standardwert ist leer, d. h. die Referenzen werden nicht anhand des Zielframeworks gefiltert.