Informations de référence sur les tâches MSBuildMSBuild Task Reference

Les tâches fournissent le code exécuté pendant le processus de génération.Tasks provide the code that runs during the build process. Les tâches de la liste suivante sont incluses dans MSBuildMSBuild.The tasks in the following list are included with MSBuildMSBuild. Quand Visual C++Visual C++ est installé, des tâches supplémentaires sont disponibles pour générer des projets Visual C++Visual C++.When Visual C++Visual C++ is installed, additional tasks are available that are used to build Visual C++Visual C++ projects. Pour plus d’informations, consultez Tâches Visual C++.For more information, see Visual C++ Tasks.

Outre les paramètres répertoriés dans les rubriques de cette section, chaque tâche comprend les paramètres suivants :In addition to the parameters listed in the topics in this section, each task also has the following parameters:

ParamètreParameter DescriptionDescription
Condition Paramètre String facultatif.Optional String parameter.

Expression Boolean utilisée par le moteur MSBuildMSBuild pour déterminer si cette tâche va être exécutée.A Boolean expression that the MSBuildMSBuild engine uses to determine whether this task will be executed. Pour plus d’informations sur les conditions prises en charge par MSBuildMSBuild, consultez Conditions.For information about the conditions that are supported by MSBuildMSBuild, see Conditions.
ContinueOnError Paramètre facultatif.Optional parameter. Peut contenir l’une des valeurs suivantes :Can contain one of the following values:

- WarnAndContinue ou true.- WarnAndContinue or true. En cas d’échec d’une tâche, l’exécution des tâches suivantes de l’élément Target et de la génération se poursuit, et toutes les erreurs de la tâche sont considérées comme des avertissements.When a task fails, subsequent tasks in the Target element and the build continue to execute, and all errors from the task are treated as warnings.
- ErrorAndContinue.- ErrorAndContinue. En cas d’échec d’une tâche, l’exécution des tâches suivantes de l’élément Target et de la génération se poursuit, et toutes les erreurs de la tâche sont considérées comme des erreurs.When a task fails, subsequent tasks in the Target element and the build continue to execute, and all errors from the task are treated as errors.
- ErrorAndStop ou false (par défaut).- ErrorAndStop or false (default). En cas d’échec d’une tâche, les tâches restantes de l’élément Target et de la génération ne sont pas exécutées, et tout l’élément Target ainsi que la génération sont considérés comme étant en échec.When a task fails, the remaining tasks in the Target element and the build aren't executed, and the entire Target element and the build is considered to have failed.

Les versions de .NET Framework antérieures à 4.5 prenaient en charge uniquement les valeurs true et false.Versions of the .NET Framework before 4.5 supported only the true and false values.

Pour plus d’informations, consultez Guide pratique pour ignorer des erreurs dans des tâches.For more information, see How to: Ignore Errors in Tasks.

Dans cette sectionIn This Section

Classe de base de tâcheTask Base Class
Ajoute plusieurs paramètres aux tâches qui dérivent de la classe Task.Adds several parameters to the tasks that derive from the Task class.

Classe de base TaskExtensionTaskExtension Base Class
Ajoute plusieurs paramètres aux tâches qui dérivent de la classe TaskExtension.Adds several parameters to the tasks that derive from the TaskExtension class.

Classe de base ToolTaskExtensionToolTaskExtension Base Class
Ajoute plusieurs paramètres aux tâches qui dérivent de la classe ToolTaskExtension.Adds several parameters to the tasks that derive from the ToolTaskExtension class.

AL (Assembly Linker), tâcheAL (Assembly Linker) Task
Crée un assembly avec un manifeste à partir d’un ou de plusieurs fichiers qui sont soit des modules, soit des fichiers de ressources.Creates an assembly with a manifest from one or more files that are either modules or resource files.

AspNetCompiler, tâcheAspNetCompiler Task
Inclut dans un wrapper aspnet_compiler.exe, un utilitaire permettant de précompiler des applications ASP.NET.Wraps aspnet_compiler.exe, a utility to precompile ASP.NET applications.

AssignCulture, tâcheAssignCulture Task
Assigne des identificateurs de culture aux éléments.Assigns culture identifiers to items.

AssignProjectConfiguration, tâcheAssignProjectConfiguration Task
Accepte une liste de chaînes de configuration et les assigne aux projets spécifiés.Accepts a list of configuration strings and assigns them to specified projects.

AssignTargetPath, tâcheAssignTargetPath Task
Accepte une liste des fichiers et ajoute des attributs <TargetPath> s’ils ne sont pas déjà spécifiés.Accepts a list of files and adds <TargetPath> attributes if they are not already specified.

CallTarget, tâcheCallTarget Task
Appelle une cible dans le fichier projet.Invokes a target in the project file.

CombinePath, tâcheCombinePath Task
Combine les chemins spécifiés en un chemin unique.Combines the specified paths into a single path.

ConvertToAbsolutePath, tâcheConvertToAbsolutePath Task
Convertit une référence ou un chemin relatif en chemin absolu.Converts a relative path or reference into an absolute path.

Copy, tâcheCopy Task
Copie les fichiers dans un nouvel emplacement.Copies files to a new location.

CreateCSharpManifestResourceName, tâcheCreateCSharpManifestResourceName Task
Crée un nom de manifeste de style Visual C#Visual C# à partir d’un nom de fichier .resx donné ou d’une autre ressource.Creates a Visual C#Visual C#-style manifest name from a given .resx file name or other resource.

CreateItem, tâcheCreateItem Task
Remplit des collections d’éléments à partir des éléments d’entrée, en autorisant la copie d’éléments d’une liste dans une autre.Populates item collections from the input items, allowing items to be copied from one list to another.

CreateProperty, tâcheCreateProperty Task
Remplit des propriétés à partir des valeurs d’entrée, en autorisant la copie de valeurs d’une propriété ou d’une chaîne dans une autre.Populates properties from the input values, allowing values to be copied from one property or string to another.

CreateVisualBasicManifestResourceName, tâcheCreateVisualBasicManifestResourceName Task
Crée un nom de manifeste de style Visual BasicVisual Basic à partir d’un nom de fichier .resx donné ou d’une autre ressource.Creates a Visual BasicVisual Basic-style manifest name from a given .resx file name or other resource.

Csc, tâcheCsc Task
Appelle le compilateur Visual C# pour produire des exécutables, des bibliothèques de liens dynamiques ou des modules de code.Invokes the Visual C# compiler to produce executables, dynamic-link libraries, or code modules.

Delete, tâcheDelete Task
Supprime les fichiers spécifiés.Deletes the specified files.

Error, tâcheError Task
Arrête une génération et enregistre une erreur en fonction d’une instruction conditionnelle évaluée.Stops a build and logs an error based on an evaluated conditional statement.

Exec, tâcheExec Task
Exécute la commande ou le programme spécifié avec les arguments spécifiés.Runs the specified program or command with the specified arguments.

FindAppConfigFile, tâcheFindAppConfigFile Task
Recherche le fichier app.config, le cas échéant, dans les listes fournies.Finds the app.config file, if any, in the provided lists.

FindInList, tâcheFindInList Task
Recherche un élément dans une liste spécifiée associée à la spécification d’éléments (itemspec) correspondante.Finds an item in a specified list that has the matching itemspec.

FindUnderPath, tâcheFindUnderPath Task
Détermine les éléments de la collection spécifiée qui existent dans le dossier spécifié et tous ses sous-dossiers.Determines which items in the specified item collection exist in the specified folder and all of its subfolders.

FormatUrl, tâcheFormatUrl Task
Convertit une URL en URL au format correct.Converts a URL to a correct URL format.

FormatVersion, tâcheFormatVersion Task
Ajoute le numéro de révision au numéro de version.Appends the revision number to the version number.

GenerateApplicationManifest, tâcheGenerateApplicationManifest Task
Génère un manifeste d’application ClickOnceClickOnce ou un manifeste natif.Generates a ClickOnceClickOnce application manifest or a native manifest.

GenerateBootstrapper, tâcheGenerateBootstrapper Task
Fournit un moyen automatisé de détecter, télécharger et installer une application et ses composants requis.Provides an automated way to detect, download, and install an application and its prerequisites.

GenerateDeploymentManifest, tâcheGenerateDeploymentManifest Task
Génère un manifeste de déploiement ClickOnceClickOnce.Generates a ClickOnceClickOnce deployment manifest.

GenerateResource, tâcheGenerateResource Task
Convertit les fichiers .txt et .resx en fichiers .resources binaires du Common Language Runtime.Converts .txt and .resx files to common language runtime binary .resources files.

GenerateTrustInfo, tâcheGenerateTrustInfo Task
Génère le niveau de confiance de l’application à partir du manifeste de base, ainsi que des paramètres TargetZone et ExcludedPermissions.Generates the application trust from the base manifest, and from the TargetZone and ExcludedPermissions parameters.

GetAssemblyIdentity, tâcheGetAssemblyIdentity Task
Récupère les identités d’assembly des fichiers spécifiés et génère les informations d’identité.Retrieves the assembly identities from the specified files and outputs the identity information.

GetFrameworkPath, tâcheGetFrameworkPath Task
Récupère le chemin aux assemblys .NET Framework.NET Framework.Retrieves the path to the .NET Framework.NET Framework assemblies.

GetFrameworkSdkPath, tâcheGetFrameworkSdkPath Task
Récupère le chemin au Kit de développement logiciel WindowsWindows Software Development Kit (SDK).Retrieves the path to the Kit de développement logiciel WindowsWindows Software Development Kit (SDK).

GetReferenceAssemblyPaths, tâcheGetReferenceAssemblyPaths Task
Retourne les chemins des assemblys de référence des différentes infrastructures.Returns the reference assembly paths of the various frameworks.

LC, tâcheLC Task
Génère un fichier .license à partir d’un fichier .licx.Generates a .license file from a .licx file.

MakeDir, tâcheMakeDir Task
Crée des répertoires et, si nécessaire, des répertoires parents.Creates directories and, if necessary, any parent directories.

Message, tâcheMessage Task
Enregistre un message pendant une génération.Logs a message during a build.

Move, tâcheMove Task
Déplace les fichiers vers un nouvel emplacement.Moves files to a new location.

MSBuild, tâcheMSBuild Task
Génère des projets MSBuildMSBuild à partir d’un autre projet MSBuildMSBuild.Builds MSBuildMSBuild projects from another MSBuildMSBuild project.

ReadLinesFromFile, tâcheReadLinesFromFile Task
Lit une liste d’éléments à partir d’un fichier texte.Reads a list of items from a text file.

RegisterAssembly, tâcheRegisterAssembly Task
Lit les métadonnées dans l’assembly spécifié et ajoute les entrées nécessaires au Registre.Reads the metadata within the specified assembly and adds the necessary entries to the registry.

RemoveDir, tâcheRemoveDir Task
Supprime les répertoires spécifiés ainsi que tous leurs fichiers et sous-répertoires.Removes the specified directories and all of its files and subdirectories.

RemoveDuplicates, tâcheRemoveDuplicates Task
Supprime les éléments en double de la collection d’éléments spécifiée.Removes duplicate items from the specified item collection.

RequiresFramework35SP1Assembly, tâcheRequiresFramework35SP1Assembly Task
Détermine si l’application nécessite le .NET Framework 3.5 SP1.Determines whether the application requires the .NET Framework 3.5 SP1.

ResGen, tâcheResGen Task
Obsolète.Obsolete. Utilisez la tâche GenerateResource Task pour convertir des fichiers .txt et .resx en fichiers .resources binaires du Common Language Runtime, et vice versa.Use the GenerateResource Task task to convert .txt and .resx files to and from common language runtime binary .resources files.

ResolveAssemblyReference, tâcheResolveAssemblyReference Task
Détermine tous les assemblys qui dépendent des assemblys spécifiés.Determines all assemblies that depend on the specified assemblies.

ResolveCOMReference, tâcheResolveComReference Task
Prend une liste d’un ou plusieurs noms de bibliothèques de types ou de fichiers .tlb et résout ces bibliothèques de types aux emplacements sur le disque.Takes a list of one or more type library names or .tlb files and resolves those type libraries to locations on disk.

ResolveKeySource, tâcheResolveKeySource Task
Détermine la source des clés à nom fort.Determines the strong name key source

ResolveManifestFiles, tâcheResolveManifestFiles Task
Résout les éléments suivants dans le processus de génération en fichiers pour la génération de manifeste : éléments générés, dépendances, satellites, contenu, symboles de débogage et documentation.Resolves the following items in the build process to files for manifest generation: built items, dependencies, satellites, content, debug symbols, and documentation.

ResolveNativeReference, tâcheResolveNativeReference Task
Résout les références natives.Resolves native references.

ResolveNonMSBuildProjectOutput, tâcheResolveNonMSBuildProjectOutput Task
Détermine les fichiers de sortie des références de projet non-MSBuild.Determines the output files for non-MSBuild project references.

SGen, tâcheSGen Task
Crée un assembly de sérialisation XML pour les types dans l’assembly spécifié.Creates an XML serialization assembly for types in the specified assembly.

SignFile, tâcheSignFile Task
Signe le fichier spécifié à l'aide du certificat spécifié.Signs the specified file using the specified certificate.

Touch, tâcheTouch Task
Définit les heures d’accès et de modification des fichiers.Sets the access and modification times of files.

UnregisterAssembly, tâcheUnregisterAssembly Task
Désinscrit les assemblys spécifiés dans le cadre de COM Interop.Unregisters the specified assemblies for COM interop purposes.

UpdateManifest, tâcheUpdateManifest Task
Met à jour les propriétés sélectionnées dans un manifeste et signe à nouveau.Updates selected properties in a manifest and resigns.

Vbc, tâcheVbc Task
Appelle le compilateur Visual Basic pour produire des exécutables, des bibliothèques de liens dynamiques ou des modules de code.Invokes the Visual Basic compiler to produce executables, dynamic-link libraries, or code modules..

Avertissement, tâcheWarning Task
Enregistre un avertissement durant une génération en fonction d’une instruction conditionnelle évaluée.Logs a warning during a build based on an evaluated conditional statement.

WriteCodeFragment, tâcheWriteCodeFragment Task
Génère un fichier de code temporaire à l’aide du fragment de code généré spécifié.Generates a temporary code file by using the specified generated code fragment. Ne supprime pas le fichier.Does not delete the file.

WriteLinesToFile, tâcheWriteLinesToFile Task
Écrit les éléments spécifiés dans le fichier texte spécifié.Writes the specified items to the specified text file.

XmlPeek, tâcheXmlPeek Task
Retourne des valeurs comme spécifié par la requête XPath à partir d’un fichier XML.Returns values as specified by XPath query from an XML file.

XmlPoke, tâcheXmlPoke Task
Définit les valeurs comme spécifié par une requête XPath dans un fichier XML.Sets values as specified by an XPath query into an XML file.

XslTransformation, tâcheXslTransformation Task
Transforme une entrée XML à l’aide d’une transformation XLS (XSLT) ou d’un XSLT compilé et envoie la sortie vers un fichier ou un périphérique de sortie.Transforms an XML input by using an Extensible Stylesheet Language Transformation (XSLT) or compiled XSLT and outputs to an output device or a file.

Voir aussiSee Also

Référence MSBuild MSBuild Reference
Task Writing (Écriture de tâches) Task Writing
Tâches MSBuildTasks