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, voir 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, voir Guide pratique : Ignorer les erreurs dans les tâches.For more information, see How to: Ignore errors in tasks.

Dans cette sectionIn this section

Classe de base TaskTask 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.

Tâche AL (Assembly Linker)AL (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.

Tâche AspNetCompilerAspNetCompiler 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.

Tâche AssignCultureAssignCulture task
Assigne des identificateurs de culture aux éléments.Assigns culture identifiers to items.

Tâche AssignProjectConfigurationAssignProjectConfiguration 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.

Tâche AssignTargetPathAssignTargetPath 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.

Tâche CallTargetCallTarget task
Appelle une cible dans le fichier projet.Invokes a target in the project file.

Tâche CombinePathCombinePath task
Combine les chemins spécifiés en un chemin unique.Combines the specified paths into a single path.

Tâche ConvertToAbsolutePathConvertToAbsolutePath task
Convertit une référence ou un chemin relatif en chemin absolu.Converts a relative path or reference into an absolute path.

Tâche CopyCopy task
Copie les fichiers dans un nouvel emplacement.Copies files to a new location.

Tâche CreateCSharpManifestResourceNameCreateCSharpManifestResourceName 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.

Tâche CreateItemCreateItem 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.

Tâche CreatePropertyCreateProperty 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.

Tâche CreateVisualBasicManifestResourceNameCreateVisualBasicManifestResourceName 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.

Tâche CscCsc 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.

Tâche DeleteDelete task
Supprime les fichiers spécifiés.Deletes the specified files.

Tâche DownloadFileDownloadFile task
Télécharge un fichier à l’emplacement spécifié.Downloads a file to the specified location.

Tâche ErrorError 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.

Tâche ExecExec 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.

Tâche FindAppConfigFileFindAppConfigFile 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.

Tâche FindInListFindInList 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.

Tâche FindUnderPathFindUnderPath 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.

Tâche FormatUrlFormatUrl task
Convertit une URL en URL au format correct.Converts a URL to a correct URL format.

Tâche FormatVersionFormatVersion 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.

Tâche GenerateBootstrapperGenerateBootstrapper 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.

Tâche GenerateDeploymentManifestGenerateDeploymentManifest task
Génère un manifeste de déploiement ClickOnceClickOnce.Generates a ClickOnceClickOnce deployment manifest.

Tâche GenerateResourceGenerateResource 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.

Tâche GenerateTrustInfoGenerateTrustInfo 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.

Tâche GetAssemblyIdentityGetAssemblyIdentity 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.

Tâche GetFrameworkPathGetFrameworkPath task
Récupère le chemin aux assemblys .NET Framework.NET Framework.Retrieves the path to the .NET Framework.NET Framework assemblies.

Tâche GetFrameworkSdkPathGetFrameworkSdkPath 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).

Tâche GetReferenceAssemblyPathsGetReferenceAssemblyPaths task
Retourne les chemins des assemblys de référence des différents frameworks.Returns the reference assembly paths of the various frameworks.

Tâche LCLC task
Génère un fichier .license à partir d’un fichier .licx.Generates a .license file from a .licx file.

Tâche MakeDirMakeDir task
Crée des répertoires et, si nécessaire, des répertoires parents.Creates directories and, if necessary, any parent directories.

Tâche MessageMessage task
Enregistre un message pendant une génération.Logs a message during a build.

Tâche MoveMove task
Déplace les fichiers vers un nouvel emplacement.Moves files to a new location.

Tâche MSBuildMSBuild task
Génère des projets MSBuildMSBuild à partir d’un autre projet MSBuildMSBuild.Builds MSBuildMSBuild projects from another MSBuildMSBuild project.

Tâche ReadLinesFromFileReadLinesFromFile task
Lit une liste d’éléments à partir d’un fichier texte.Reads a list of items from a text file.

Tâche RegisterAssemblyRegisterAssembly 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.

Tâche RemoveDirRemoveDir 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.

Tâche RemoveDuplicatesRemoveDuplicates task
Supprime les éléments en double de la collection d’éléments spécifiée.Removes duplicate items from the specified item collection.

Tâche RequiresFramework35SP1AssemblyRequiresFramework35SP1Assembly 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 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.

Tâche ResolveAssemblyReferenceResolveAssemblyReference task
Détermine tous les assemblys qui dépendent des assemblys spécifiés.Determines all assemblies that depend on the specified assemblies.

Tâche ResolveComReferenceResolveComReference 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 sous forme d’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.

Tâche ResolveKeySourceResolveKeySource task
Détermine la source des clés à nom fort.Determines the strong name key source

Tâche ResolveManifestFilesResolveManifestFiles 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.

Tâche ResolveNativeReferenceResolveNativeReference task
Résout des références natives.Resolves native references.

Tâche ResolveNonMSBuildProjectOutputResolveNonMSBuildProjectOutput task
Détermine les fichiers de sortie des références de projet non-MSBuild.Determines the output files for non-MSBuild project references.

Tâche SGenSGen 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.

Tâche TouchTouch task
Définit les heures d’accès et de modification des fichiers.Sets the access and modification times of files.

Tâche UnregisterAssemblyUnregisterAssembly task
Désinscrit les assemblys spécifiés dans le cadre de COM Interop.Unregisters the specified assemblies for COM interop purposes.

Tâche UnzipUnzip task
Décompresse une archive .zip à l’emplacement spécifié.Unzips a .zip archive to the specified location.

Tâche UpdateManifestUpdateManifest 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..

Tâche WarningWarning 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.

Tâche WriteCodeFragmentWriteCodeFragment 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.

Tâche WriteLinesToFileWriteLinesToFile task
Écrit les éléments spécifiés dans le fichier texte spécifié.Writes the specified items to the specified text file.

Tâche XmlPeekXmlPeek 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.

Tâche XmlPokeXmlPoke 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.

Tâche XslTransformationXslTransformation 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.

Tâche ZipDirectoryZipDirectory task
Crée une archive .zip à partir du contenu d’un répertoire.Creates a .zip archive from the contents of a directory.

Voir aussiSee also

Informations de référence sur MSBuild MSBuild reference
Écriture de tâches Task writing
TâchesTasks