Vbc Task

 

Date de publication : juin 2016

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Inclut vbc.exe dans un wrapper, ce qui produit des fichiers exécutables (.exe), des bibliothèques de liens dynamiques (.dll) ou des modules de code (. netmodule). Pour plus d'informations sur vbc.exe, consultez Visual Basic Command-Line Compiler.

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

ParamètreDescription
AdditionalLibPathsParamètre String[] facultatif.

Spécifie les dossiers supplémentaires dans lesquels rechercher les assemblys spécifiés dans l'attribut References.
AddModulesParamètre String[] facultatif.

Entraîne le compilateur à donner des informations de type dans le ou les fichiers spécifiés disponibles pour le projet en cours de compilation. Ce paramètre correspond au commutateur /addmodule du compilateur vbc.exe.
BaseAddressParamètre String facultatif.

Spécifie l'adresse de base de la DLL. Ce paramètre correspond au commutateur /baseaddress du compilateur vbc.exe.
CodePageParamètre Int32 facultatif.

Spécifie la page de codes à utiliser pour tous les fichiers de code source inclus dans la compilation. Ce paramètre correspond au commutateur /codepage du compilateur vbc.exe.
DebugTypeParamètre String[] facultatif.

Entraîne le compilateur à générer des informations de débogage. Ce paramètre peut avoir les valeurs suivantes :

- full
- pdbonly

La valeur par défaut, full, active l'attachement d'un débogueur au programme en cours d'exécution. La valeur pdbonly permet un débogage du code source lorsque le programme est démarré dans le débogueur, mais affiche du code en langage assembleur uniquement lorsque le programme en cours d'exécution est attaché au débogueur. Pour plus d'informations, consultez /debug.
DefineConstantsParamètre String[] facultatif.

Définit des constantes de compilation conditionnelle. Les paires symbole/valeur sont séparées par des points-virgules et spécifiées avec la syntaxe suivante :

 symbole1 = valeur1 ; symbole2 = valeur2

Ce paramètre correspond au commutateur /define du compilateur vbc.exe.
DelaySignParamètre Boolean facultatif.

Si la valeur est true, la tâche place la clé publique dans l'assembly. Si la valeur est false, la tâche signe complètement l'assembly. La valeur par défaut est false. Ce paramètre n'a aucun effet à moins d'être utilisé avec le paramètre KeyFile ou KeyContainer. Ce paramètre correspond au commutateur /delaysign du compilateur vbc.exe.
DisabledWarningsParamètre String facultatif.

Supprime les avertissements spécifiés. Il suffit de spécifier la partie numérique de l'identificateur de l'avertissement. Les différents avertissements sont séparés par des points-virgules. Ce paramètre correspond au commutateur /nowarn du compilateur vbc.exe.
DocumentationFileParamètre String facultatif.

Traite les commentaires de documentation pour les diriger vers le fichier XML spécifié. Ce paramètre se substitue au paramètre GenerateDocumentation. Pour plus d'informations, consultez /doc.
EmitDebugInformationParamètre Boolean facultatif.

Si la valeur est true, la tâche génère des informations de débogage et les place dans un fichier de base de données de programme (.pdb). Pour plus d'informations, consultez /debug.
ErrorReportParamètre String facultatif.

Indique comment la tâche doit signaler des erreurs internes du compilateur. Ce paramètre peut avoir les valeurs suivantes :

- prompt
- send
- none

Si prompt est spécifié et qu'une erreur interne du compilateur se produit, l'utilisateur est invité à choisir d'envoyer ou non les données d'erreur à Microsoft.

Si send est spécifié et qu'une erreur interne du compilateur se produit, la tâche envoie les données d'erreur à Microsoft.

La valeur par défaut est none, qui signale les erreurs dans une sortie texte uniquement.

Ce paramètre correspond au commutateur /errorreport du compilateur vbc.exe.
FileAlignmentParamètre Int32 facultatif.

Spécifie, en octets, où les sections du fichier de sortie doivent être alignées. Ce paramètre peut avoir les valeurs suivantes :

- 512
- 1024
- 2048
- 4096
- 8192

Ce paramètre correspond au commutateur /filealign du compilateur vbc.exe.
GenerateDocumentationParamètre Boolean facultatif.

Si sa valeur est true, il génère des informations de documentation et les place dans un fichier XML avec le nom de la bibliothèque ou du fichier exécutable créé par la tâche. Pour plus d'informations, consultez /doc.
ImportsParamètre ITaskItem[] optionnel.

Importe des espaces de noms à partir des collections d'éléments spécifiées. Ce paramètre correspond au commutateur /imports du compilateur vbc.exe.
KeyContainerParamètre String facultatif.

Spécifie le nom du conteneur de clé de chiffrement. Ce paramètre correspond au commutateur /keycontainer du compilateur vbc.exe.
KeyFileParamètre String facultatif.

Spécifie le nom de fichier qui contient la clé de chiffrement. Pour plus d'informations, consultez /keyfile.
LangVersionParamètre String facultatif.

Spécifie la version linguistique (« 9 » ou « 10 »).
LinkResourcesParamètre ITaskItem[] optionnel.

Crée un lien avec une ressource du .NET Framework dans le fichier de sortie ; le fichier de ressources n'est pas stocké dans le fichier de sortie. Ce paramètre correspond au commutateur /linkresource du compilateur vbc.exe.
MainEntryPointParamètre String facultatif.

Spécifie la classe ou le module qui contient la procédure Sub Main. Ce paramètre correspond au commutateur /main du compilateur vbc.exe.
ModuleAssemblyNameParamètre String facultatif.

Spécifie l'assembly dont ce module fait partie.
NoConfigParamètre Boolean facultatif.

Indique que le compilateur ne doit pas utiliser le fichier vbc.rsp. Ce paramètre correspond au commutateur /noconfig du compilateur vbc.exe.
NoLogoParamètre Boolean facultatif.

Si sa valeur est true, il supprime l'affichage d'informations sur la bannière du compilateur. Ce paramètre correspond au commutateur /nologo du compilateur vbc.exe.
NoStandardLibParamètre Boolean facultatif.

Empêche le compilateur de référencer les bibliothèques standard. Ce paramètre correspond au commutateur /nostdlib du compilateur vbc.exe.
NoVBRuntimeReferenceParamètre Boolean facultatif.

Usage interne uniquement. Si la valeur est true, la référence automatique à Microsoft.VisualBasic.dll est impossible.
NoWarningsParamètre Boolean facultatif.

Si la valeur est true, la tâche supprime tous les avertissements. Pour plus d'informations, consultez /nowarn.
OptimizeParamètre Boolean facultatif.

Si sa valeur est true, il active les optimisations du compilateur. Ce paramètre correspond au commutateur /optimize du compilateur vbc.exe.
OptionCompareParamètre String facultatif.

Spécifie la façon dont sont effectuées les comparaisons de chaînes. Ce paramètre peut avoir les valeurs suivantes :

- binary
- text

La valeur binary spécifie que la tâche utilise des comparaisons de chaînes binaires. La valeur text indique que la tâche utilise des comparaisons de chaînes de texte. La valeur par défaut de ce paramètre est binary. Ce paramètre correspond au commutateur /optioncompare du compilateur vbc.exe.
OptionExplicitParamètre Boolean facultatif.

Si la valeur est true, la déclaration explicite de variables est requise. Ce paramètre correspond au commutateur /optionexplicit du compilateur vbc.exe.
OptionInferParamètre Boolean facultatif.

Si la valeur est true, l'inférence de types de variables est autorisée.
OptionStrictParamètre Boolean facultatif.

Si la valeur est true, la tâche applique une sémantique de type stricte pour limiter les conversions de types implicites. Ce paramètre correspond au commutateur /optionstrict du compilateur vbc.exe.
OptionStrictTypeParamètre String facultatif.

Spécifie quelle sémantique de type stricte génère un avertissement. Actuellement, seul "custom" est pris en charge. Ce paramètre correspond au commutateur /optionstrict du compilateur vbc.exe.
OutputAssemblyParamètre de sortie String facultatif.

Spécifie le nom du fichier de sortie. Ce paramètre correspond au commutateur /out du compilateur vbc.exe.
PlatformParamètre String facultatif.

Spécifie la plateforme du processeur ciblée par le fichier de sortie. Ce paramètre peut avoir les valeurs x86, x64, Itanium ou anycpu. La valeur par défaut est anycpu. Ce paramètre correspond au commutateur /platform du compilateur vbc.exe.
ReferencesParamètre ITaskItem[] optionnel.

Entraîne la tâche à importer des informations de type public à partir des éléments spécifiés dans le projet actif. Ce paramètre correspond au commutateur /reference du compilateur vbc.exe.
RemoveIntegerChecksParamètre Boolean facultatif.

Si la valeur est true, il désactive les vérifications d'erreur de dépassement sur les entiers. La valeur par défaut est false. Ce paramètre correspond au commutateur /removeintchecks du compilateur vbc.exe.
ResourcesParamètre ITaskItem[] optionnel.

Incorpore une ressource .NET Framework dans le fichier de sortie. Ce paramètre correspond au commutateur /resource du compilateur vbc.exe.
ResponseFilesParamètre ITaskItem[] optionnel.

Spécifie le fichier réponse qui contient les commandes pour cette tâche. Ce paramètre correspond à l'option @ (Specify Response File) du compilateur vbc.exe.
RootNamespaceParamètre String facultatif.

Spécifie l'espace de noms racine pour toutes les déclarations de type. Ce paramètre correspond au commutateur /rootnamespace du compilateur vbc.exe.
SdkPathParamètre String facultatif.

Spécifie l'emplacement de mscorlib.dll et de microsoft.visualbasic.dll. Ce paramètre correspond au commutateur /sdkpath du compilateur vbc.exe.
SourcesParamètre ITaskItem[] optionnel.

Spécifie un ou plusieurs fichiers sources Visual Basic.
TargetCompactFrameworkParamètre Boolean facultatif.

Si la valeur est true, la tâche cible le .NET Compact Framework. Ce commutateur correspond au commutateur /netcf du compilateur vbc.exe.
TargetTypeParamètre String facultatif.

Spécifie le format du fichier de sortie. Ce paramètre peut avoir la valeur library pour créer une bibliothèque de code, exe pour créer une application console, module pour créer un module ou winexe pour créer un programme Windows. La valeur par défaut est library. Ce paramètre correspond au commutateur /target du compilateur vbc.exe.
TimeoutParamè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.
ToolPathParamètre String facultatif.

Spécifie l'emplacement à partir duquel la tâche charge le fichier exécutable sous-jacent (vbc.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.
TreatWarningsAsErrorsParamètre Boolean facultatif.

Si la valeur est true, tous les avertissements sont traités comme des erreurs. Pour plus d'informations, consultez /warnaserror.
UseHostCompilerIfAvailableParamètre Boolean facultatif.

Indique à la tâche d'utiliser l'objet compilateur in-process, s'il est disponible. Utilisé uniquement par Visual Studio.
Utf8OutputParamètre Boolean facultatif.

Affiche les résultats de la compilation en encodage UTF-8. Ce paramètre correspond au commutateur /utf8output du compilateur vbc.exe.
VerbosityParamètre String facultatif.

Spécifie le niveau de commentaires de la sortie de compilation. Le niveau de commentaires peut avoir la valeur Quiet, Normal (par défaut) ou Verbose.
WarningsAsErrorsParamètre String facultatif.

Spécifie une liste d'avertissements à traiter comme des erreurs. Pour plus d'informations, consultez /warnaserror.

Ce paramètre se substitue au paramètre TreatWarningsAsErrors.
WarningsNotAsErrorsParamètre String facultatif.

Spécifie une liste d'avertissements à ne pas traiter comme des erreurs. Pour plus d'informations, consultez /warnaserror.

Ce paramètre n'est utile que lorsque la propriété TreatWarningsAsErrors a la valeur true.
Win32IconParamètre String facultatif.

Insère un fichier .ico dans l'assembly, qui donne au fichier de sortie l'apparence souhaitée dans l'Explorateur de fichiers. Ce paramètre correspond au commutateur /win32icon du compilateur vbc.exe.
Win32ResourcesParamètre String facultatif.

Insère un fichier de ressources Win32 (.res) dans le fichier de sortie. Ce paramètre correspond au commutateur /win32resource du compilateur vbc.exe.

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe ToolTaskExtension, qui hérite elle-même de la classe ToolTask. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez ToolTaskExtension Base Class.

L'exemple suivant compile un projet Visual Basic.

<VBC  
   Sources="@(sources)"  
   Resources="strings.resources"  
   Optimize="true"  
   OutputAssembly="out.exe"/>  

Visual Basic Command-Line Compiler
Tasks
Task Reference

Afficher: