ResolveAssemblyReference, tâche

AllowedRelatedFileExtensions

Paramètre String[] facultatif.

Extensions de nom de fichier à utiliser dans le cadre d'une recherche de fichiers liés les uns aux autres. Les extensions par défaut sont .pdb et .xml.

Assemblies

Paramètre ITaskItem[] facultatif.

Spécifie les éléments pour lesquels des chemins d'accès complets et des dépendances doivent être identifiés. Ces éléments peuvent porter des noms simples tels que « System » ou des noms forts, comme « System, Version=2.0.3500.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 ».

Les éléments passés à ce paramètre peuvent éventuellement comporter les métadonnées d'élément suivantes :

• Private : valeur Boolean. Si la valeur est true, l'élément est copié localement. La valeur par défaut est true.

• HintPath : valeur String. Spécifie le chemin d'accès et le nom de fichier à utiliser comme référence. Ce paramètre est utilisé lorsque {HintPathFromItem} est spécifié dans le paramètre SearchPaths. La valeur par défaut est une chaîne vide.

• SpecificVersion : valeur Boolean. Si la valeur est true, le nom exact spécifié dans l'attribut Include doit correspondre. Si la valeur est false, tout assembly avec le même nom simple est utilisé. Si SpecificVersion n'est pas spécifié, la tâche prend en compte la valeur dans l'attribut Include de l'élément. Si l'attribut est un nom simple, il se comporte comme si SpecificVersion avait la valeur false. Si l'attribut est un nom fort, il se comporte comme si SpecificVersion avait la valeur true.

• ExecutableExtension : valeur String. Lorsque cet attribut est présent, l'assembly résolu doit avoir cette extension. Lorsque cet attribut est absent, .dll est d'abord pris en compte, suivi de .exe, pour chaque répertoire exploré.

• SubType : valeur String. Seuls les éléments avec des métadonnées SubType vides sont résolus en chemins d'accès d'assembly complets. Les éléments comportant des métadonnées SubType non vides sont ignorés.

• AssemblyFolderKey : valeur String. Ces métadonnées sont prises en charge à des fins d'héritage. Elles spécifient une clé de Registre définie par l'utilisateur, comme « hklm\VendorFolder », que Assemblies doit utiliser pour résoudre des références d'assembly.

AutoUnify

Paramètre Boolean facultatif.

Si la valeur est true, le graphique de dépendance résultant est automatiquement traité comme si un fichier App.Config était passé au paramètre AppConfigFile. Ce fichier App.Config virtuel a une entrée bindingRedirect pour chaque ensemble d'assemblys en conflit, de sorte que l'assembly avec la version la plus récente est choisi. Par conséquent, vous ne recevrez jamais de message d'avertissement concernant des assemblys en conflit, car tous les conflits auront déjà été résolus. Chaque remappage distinct générera un commentaire de priorité élevée qui indique les versions ancienne et nouvelle et le fait que cette opération ait été exécutée automatiquement dans la mesure où AutoUnify avait la valeur true.

Si la valeur est false, aucun remappage de version d'assembly n'est effectué automatiquement. Lorsque deux versions d'un assembly sont présentes, un avertissement est émis. Chaque conflit distinct entre des versions différentes du même assembly provoque l'émission d'un commentaire de priorité élevée. Une fois tous ces commentaires affichés, un avertissement avec un code d'erreur unique et le texte « Des conflits entre différentes versions du même assembly dépendant ont été rencontrés » s'affiche.

La valeur par défaut est false.

CopyLocalFiles

Paramètre de sortie en lecture seule ITaskItem[] facultatif.

Retourne chaque fichier dans les paramètres ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles et ScatterFiles qui possède des métadonnées d'élément CopyLocal avec la valeur true.

FindDependencies

Paramètre Boolean facultatif.

Si la valeur est true, des dépendances sont recherchées. Sinon, seules les références principales sont recherchées. La valeur par défaut est true.

FindSatellites

Paramètre Boolean facultatif.

Si la valeur est true, les assemblys satellites sont recherchés. La valeur par défaut est true.

FullTargetFrameworkSubsetNames

Paramètre String[] facultatif.

Contient la liste des noms des sous-ensembles de la version cible de .Net Framework. Si le nom d'un sous-ensemble de la liste correspond à celui inclus dans la propriété de nom TargetFrameworkSubset, le système exclut ce sous-ensemble particulier de la version cible de .Net Framework au moment de la génération.

IgnoreDefaultInstalledAssemblySubsetTables

Paramètre Boolean facultatif.

Si la valeur est true, la tâche recherche et utilise les tables de sous-ensembles d'assemblys installés supplémentaires (ou « listes de sous-ensembles ») trouvées dans le répertoire \SubsetList sous TargetFrameworkDirectories. La valeur par défaut est false.

InstalledAssemblyTables

Paramètre String facultatif.

Contient la liste des fichiers XML qui spécifient les assemblys attendus pour être installés sur l'ordinateur cible.

Si InstalledAssemblyTables est défini, les versions antérieures des assemblys de la liste sont fusionnées dans les versions plus récentes répertoriées dans le code XML. En outre, les assemblys qui présentent le paramètre InGAC='true' sont considérés comme des composants requis et ont le paramètre CopyLocal='false', sauf en cas de substitution explicite.

En option, les éléments de cette liste peuvent spécifier des métadonnées « FrameworkDirectory » afin d'associer InstalledAssemblyTable à un répertoire Framework particulier. Toutefois, ce paramètre est ignoré, sauf si le nom du composant redistribuable (Redist) commence par

« Microsoft-Windows-CLRCoreComp ».

S'il n'existe qu'un seul élément TargetFrameworkDirectories, tous les éléments de cette liste dépourvus des métadonnées « FrameworkDirectory » sont traités comme s'ils avaient la valeur unique passée

à TargetFrameworkDirectories.

ResolvedDependencyFiles

Paramètre de sortie en lecture seule ITaskItem[] facultatif.

Contient les chemins d'accès de n ordre aux dépendances. Ce paramètre n'inclut pas les références principales de premier ordre contenues dans le paramètre ResolvedFiles.

Les éléments de ce paramètre peuvent contenir les métadonnées d'élément suivantes :

• CopyLocal : valeur Boolean. Indique si la référence donnée doit être copiée vers le répertoire de sortie.

• FusionName : valeur String. Spécifie le nom de cette dépendance.

• ResolvedFrom : valeur String. Spécifie le chemin de recherche littéral à partir duquel ce fichier a été résolu.

SatelliteFiles

Paramètre de sortie en lecture seule ITaskItem[] facultatif.

Spécifie les fichiers satellites recherchés. La valeur sera CopyLocal=true si la référence ou la dépendance qui a provoqué la création de cet élément est CopyLocal=true.

Les éléments de ce paramètre peuvent contenir les métadonnées d'élément suivantes :

• CopyLocal : valeur Boolean. Indique si la référence donnée doit être copiée vers le répertoire de sortie. Cette valeur est true si la référence ou la dépendance qui a provoqué la création de cet élément a la valeur CopyLocaltrue.

• DestinationSubDirectory : valeur String. Spécifie le répertoire de destination relatif dans lequel copier cet élément.

SearchPaths

Paramètre String[] obligatoire.

Spécifie les répertoires ou emplacements spéciaux qui sont explorés pour rechercher les fichiers sur le disque représentant les assemblys. L'ordre dans lequel les chemins de recherche sont répertoriés est important. Pour chaque assembly, la liste des chemins d'accès est explorée de gauche à droite. Lorsqu'un fichier représentant l'assembly est détecté, cette recherche s'arrête et la recherche de l'assembly suivant démarre.

Ce paramètre accepte les types de valeurs suivants :

• Un chemin d'accès au répertoire.

• {HintPathFromItem} : spécifie que la tâche examinera les métadonnées HintPath de l'élément de base.

• {CandidateAssemblyFiles} : spécifie que la tâche examinera les fichiers passés via le paramètre CandidateAssemblyFiles.

• {Registry:_AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}:

• {AssemblyFolders} : indique que la tâche utilisera la méthode de recherche d'assemblys dans le Registre de Visual Studio .NET 2003.

• {GAC } : spécifie que la tâche effectuera des recherches dans le GAC (Global Assembly Cache).

• {RawFileName} : spécifie que la tâche considérera la valeur Include de l'élément comme un chemin d'accès et un nom de fichier exacts.

StateFile

Paramètre String facultatif.

Spécifie un nom de fichier qui indique l'endroit où enregistrer l'état de génération intermédiaire pour cette tâche.

TargetFrameworkDirectories

Paramètre String[] facultatif.

Spécifie le chemin d'accès du répertoire de la version cible de .Net Framework. Ce paramètre est nécessaire pour déterminer l'état de CopyLocal pour les éléments résultants.

Si ce paramètre n'est pas spécifié, aucun des éléments résultants ne possédera de valeur CopyLocal égale à true, à moins qu'ils aient explicitement la valeur de métadonnées Privatetrue sur leur élément source.

TargetFrameworkVersion

Paramètre String facultatif.

Version cible de .Net Framework du projet. La valeur par défaut est vide, ce qui signifie qu'il n'y a pas de filtrage pour les références basées sur la version cible de .Net Framework.