Partager via


VCBuild, tâche

Mise à jour : novembre 2007

Encapsule vcbuild.exe, qui génère des projets et des solutions Visual C++ contenant des projets Visual C++. Pour plus d'informations, consultez Référence VCBUILD.

Paramètres

Le tableau suivant décrit les paramètres de la tâche VCBuild.

Paramètre

Description

AdditionalLibPaths

Paramètre ITaskItem[] facultatif.

Spécifie des chemins d'accès supplémentaires à ajouter à la variable d'environnement LIBPATH avant d'exécuter vcbuild.exe.

AdditionalOptions

Paramètre String facultatif.

Spécifie des commutateurs de ligne de commande supplémentaires qui n'ont pas de paramètre de tâche dédié.

Clean

Paramètre Boolean facultatif.

true pour spécifier que la tâche génère uniquement des résultats de génération nettoyés. Si le paramètre Rebuild a la valeur true, il se substitue à ce paramètre.

Configuration

Paramètre String facultatif.

Spécifie le nom de la configuration et de la plateforme à utiliser pour la génération.

Par exemple : Debug|Win32.

Ce paramètre peut également être utilisé pour spécifier uniquement le nom de configuration.

Override

Paramètre ITaskItem facultatif.

Spécifie l'emplacement d'un fichier de feuille de propriétés VCBuild qui substitue des paramètres de fichier projet.

Platform

Paramètre String facultatif.

Spécifie le nom de la plateforme à générer.

Projects

Paramètre ITaskItem[] obligatoire.

Spécifie les projets à générer.

Rebuild

Paramètre Boolean facultatif.

true pour spécifier que la tâche nettoie les sorties de génération avant d'exécuter une génération. Ce paramètre se substitue au paramètre Clean.

SolutionFile

Paramètre ITaskItem facultatif.

Spécifie le chemin d'accès complet au fichier solution lors de la génération de solutions. Ce paramètre est utilisé pour résoudre des macros de projets Visual C++ relatifs aux solutions.

Timeout

Paramètre Int32 facultatif.

Spécifie la durée, en millisecondes, après laquelle la tâche exécutable est terminée. La valeur par défaut est Int.MaxValue, indiquant qu'il n'existe aucun délai d'attente.

ToolPath

Paramètre String facultatif.

Spécifie l'emplacement à partir duquel la tâche charge le fichier exécutable sous-jacent (vcbuild.exe). Si ce paramètre n'est pas spécifié, la tâche utilise le chemin d'accès d'installation du Kit de développement logiciel qui correspond à la version de l'infrastructure exécutant MSBuild.

UseEnvironment

Paramètre Boolean facultatif.

true pour utiliser des variables d'environnement pour les chemins d'accès INCLUDE et LIB ; sinon, false.

AdditionalLinkLibraryPaths

Paramètre String facultatif.

Spécifie des dossiers de référence supplémentaires à ajouter à la variable d'environnement LIB. Link.exe utilise le chemin d'accès LIB lorsqu'il recherche un fichier spécifié sur la ligne de commande Link, tel qu'un objet ou une bibliothèque. Lib.exe n'utilise pas de variable d'environnement.

Exemple

L'exemple suivant utilise la tâche VCBuild pour générer les projets spécifiés par la collection d'éléments vcprojects.

<VCBuild
   Projects="@(vcprojects)"
   Configuration="$(configuration)"
   Rebuild="true"/>

Voir aussi

Concepts

Tâches MSBuild

MSBuild

Autres ressources

Référence des tâches MSBuild