Vbc, tâcheVbc Task

Encapsule vbc.exe, qui produit des fichiers exécutables (.exe), des bibliothèques de liens dynamiques (.dll) ou des modules de code (.netmodule).Wraps vbc.exe, which produces executables (.exe), dynamic-link libraries (.dll), or code modules (.netmodule). Pour plus d’informations sur vbc.exe, consultez Compilateur de ligne de commande de Visual Basic.For more information on vbc.exe, see Visual Basic Command-Line Compiler.

ParamètresParameters

Le tableau ci-dessous décrit les paramètres de la tâche Vbc .The following table describes the parameters of the Vbc task.

ParamètreParameter DescriptionDescription
AdditionalLibPaths Paramètre String[] facultatif.Optional String[] parameter.

Spécifie des dossiers supplémentaires dans lesquels rechercher les assemblys spécifiés dans l’attribut References.Specifies additional folders in which to look for assemblies specified in the References attribute.
AddModules Paramètre String[] facultatif.Optional String[] parameter.

Entraîne la mise à disposition par le compilateur de toutes les informations de type à partir du ou des fichiers spécifiés, pour le projet en cours de compilation.Causes the compiler to make all type information from the specified file(s) available to the project you are currently compiling. Ce paramètre correspond au commutateur /addmodule du compilateur vbc.exe.This parameter corresponds to the /addmodule switch of the vbc.exe compiler.
BaseAddress Paramètre String facultatif.Optional String parameter.

Spécifie l’adresse de base de la DLL.Specifies the base address of the DLL. Ce paramètre correspond au commutateur /baseaddress du compilateur vbc.exe.This parameter corresponds to the /baseaddress switch of the vbc.exe compiler.
CodePage Paramètre Int32 facultatif.Optional Int32 parameter.

Spécifie la page de codes à utiliser pour tous les fichiers de code source inclus dans la compilation.Specifies the code page to use for all source code files in the compilation. Ce paramètre correspond au commutateur /codepage du compilateur vbc.exe.This parameter corresponds to the /codepage switch of the vbc.exe compiler.
DebugType Paramètre String[] facultatif.Optional String[] parameter.

Fait en sorte que le compilateur génère des informations de débogage.Causes the compiler to generate debugging information. Ce paramètre peut avoir les valeurs suivantes :This parameter can have the following values:

- full
- pdbonly

La valeur par défaut full, permet d’attacher un débogueur au programme en cours d’exécution.The default value is full, which enables attaching a debugger to the running program. La valeur pdbonly autorise un débogage du code source quand le programme est démarré dans le débogueur, mais affiche du code en langage assembleur uniquement quand le programme en cours d’exécution est attaché au débogueur.A value of pdbonly allows source code debugging when the program is started in the debugger, but displays assembly language code only when the running program is attached to the debugger. Pour plus d’informations, consultez /debug (Visual Basic).For more information, see /debug (Visual Basic).
DefineConstants Paramètre String[] facultatif.Optional String[] parameter.

Définit des constantes conditionnelles du compilateur.Defines conditional compiler constants. Les paires symbole/valeur sont séparées par des points-virgules et spécifiées avec la syntaxe suivante :Symbol/value pairs are separated by semicolons and are specified with the following syntax:

symbole1 = valeur1 ; symbole2 = valeur2symbol1 = value1 ; symbol2 = value2

Ce paramètre correspond au commutateur /define du compilateur vbc.exe.This parameter corresponds to the /define switch of the vbc.exe compiler.
DelaySign Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, la tâche place la clé publique dans l’assembly.If true, the task places the public key in the assembly. Si la valeur est false, la tâche signe complètement l’assembly.If false, the task fully signs the assembly. La valeur par défaut est false. Ce paramètre n’a aucun effet sauf s’il est utilisé avec le paramètre KeyFile ou KeyContainer.The default value is false.This parameter has no effect unless used with the KeyFile parameter or the KeyContainer parameter. Ce paramètre correspond au commutateur /delaysign du compilateur vbc.exe.This parameter corresponds to the /delaysign switch of the vbc.exe compiler.
DisabledWarnings Paramètre String facultatif.Optional String parameter.

Supprime les avertissements spécifiés.Suppresses the specified warnings. Vous avez besoin de spécifier uniquement la partie numérique de l’identificateur d’avertissement.You only need to specify the numeric part of the warning identifier. Les différents avertissements sont séparés par des points-virgules.Multiple warnings are separated by semicolons. Ce paramètre correspond au commutateur /nowarn du compilateur vbc.exe.This parameter corresponds to the /nowarn switch of the vbc.exe compiler.
DocumentationFile Paramètre String facultatif.Optional String parameter.

Traite les commentaires de documentation pour les diriger vers le fichier XML spécifié.Processes documentation comments to the specified XML file. Ce paramètre remplace l’attribut GenerateDocumentation.This parameter overrides the GenerateDocumentation attribute. Pour plus d’informations, consultez /doc.For more information, see /doc.
EmitDebugInformation Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, la tâche génère des informations de débogage et les place dans un fichier .pdb.If true, the task generates debugging information and places it in a .pdb file. Pour plus d’informations, consultez /debug (Visual Basic).For more information, see /debug (Visual Basic).
ErrorReport Paramètre String facultatif.Optional String parameter.

Indique comment la tâche doit signaler les erreurs internes du compilateur.Specifies how the task should report internal compiler errors. Ce paramètre peut avoir les valeurs suivantes :This parameter can have the following values:

- prompt
- send
- none

Si vous spécifiez prompt et qu’une erreur interne du compilateur se produit, l’utilisateur est invité à envoyer les données d’erreur à Microsoft.If prompt is specified and an internal compiler error occurs, the user is prompted with an option of wheter to send the error data to Microsoft.

Si vous spécifiez send et qu’une erreur interne du compilateur se produit, la tâche envoie les données d’erreur à Microsoft.If send is specified and an internal compiler error occurs, the task sends the error data to Microsoft.

La valeur par défaut est none. Elle signale les erreurs dans une sortie texte uniquement.The default value is none, which reports errors in text output only.

Ce paramètre correspond au commutateur /errorreport du compilateur vbc.exe.This parameter corresponds to the /errorreport switch of the vbc.exe compiler.
FileAlignment Paramètre Int32 facultatif.Optional Int32 parameter.

Spécifie, en octets, où les sections du fichier de sortie doivent être alignées.Specifies, in bytes, where to align the sections of the output file. Ce paramètre peut avoir les valeurs suivantes :This parameter can have the following values:

- 512
- 1024
- 2048
- 4096
- 8192

Ce paramètre correspond au commutateur /filealign du compilateur vbc.exe.This parameter corresponds to the /filealign switch of the vbc.exe compiler.
GenerateDocumentation Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, génère des informations de documentation et les place dans un fichier XML avec le nom du fichier exécutable ou de la bibliothèque créé(e) par la tâche.If true, generates documentation information and places it in an XML file with the name of the executable file or library that the task is creating. Pour plus d’informations, consultez /doc.For more information, see /doc.
Imports Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Importe des espaces de noms à partir des collections d’éléments spécifiées.Imports namespaces from the specified item collections. Ce paramètre correspond au commutateur /imports du compilateur vbc.exe.This parameter corresponds to the /imports switch of the vbc.exe compiler.
KeyContainer Paramètre String facultatif.Optional String parameter.

Spécifie le nom du conteneur de la clé de chiffrement.Specifies the name of the cryptographic key container. Ce paramètre correspond au commutateur /keycontainer du compilateur vbc.exe.This parameter corresonds to the /keycontainer switch of the vbc.exe compiler.
KeyFile Paramètre String facultatif.Optional String parameter.

Spécifie le nom du fichier contenant la clé de chiffrement.Specifies the file name containing the cryptographic key. Pour plus d’informations, consultez /keyfile.For more information, see /keyfile.
LangVersion Paramètre System.String facultatif.Optional System.String parameter.

Spécifie la version du langage, « 9 » ou « 10 ».Specifies the language version, either "9" or "10".
LinkResources Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Crée un lien à une ressource .NET Framework dans le fichier de sortie ; le fichier de ressources n’est pas placé dans le fichier de sortie.Creates a link to a .NET Framework resource in the output file; the resource file is not placed in the output file. Ce paramètre correspond au commutateur /linkresource du compilateur vbc.exe.This parameter corresponds to the /linkresource switch of the vbc.exe compiler.
MainEntryPoint Paramètre String facultatif.Optional String parameter.

Spécifie la classe ou le module qui contient la procédure Sub Main.Specifies the class or module that contains the Sub Main procedure. Ce paramètre correspond au commutateur /main du compilateur vbc.exe.This parameter corresonds to the /main switch of the vbc.exe compiler.
ModuleAssemblyName Paramètre String facultatif.Optional String parameter.

Spécifie l’assembly dont ce module fait partie.Specifies the assembly that this module is a part of.
NoConfig Paramètre Boolean facultatif.Optional Boolean parameter.

Indique que le compilateur ne doit pas utiliser le fichier vbc.rsp.Specifies that the compiler should not use the vbc.rsp file. Ce paramètre correspond au commutateur /noconfig du compilateur vbc.exe.This parameter corresponds to the /noconfig parameter of the vbc.exe compiler.
NoLogo Paramètre Boolean facultatif.Optional Boolean parameter.

Si true, supprime l’affichage des informations de bannière du compilateur.If true, suppresses display of compiler banner information. Ce paramètre correspond au commutateur /nologo du compilateur vbc.exe.This parameter corresponds to the /nologo switch of the vbc.exe compiler.
NoStandardLib Paramètre Boolean facultatif.Optional Boolean parameter.

Configure le compilateur pour ne pas référencer les bibliothèques standard.Causes the compiler not to reference the standard libraries. Ce paramètre correspond au commutateur /nostdlib du compilateur vbc.exe.This parameter corresponds to the /nostdlib switch of the vbc.exe compiler.
NoVBRuntimeReference Paramètre Boolean facultatif.Optional Boolean parameter.

Usage interne uniquement.Internal use only. Si la valeur est true, empêche la référence automatique à Microsoft.VisualBasic.dll.If true, prevents the automatic reference to Microsoft.VisualBasic.dll..
NoWarnings Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, la tâche supprime tous les avertissements.If true, the task supresses all warnings. Pour plus d’informations, consultez /nowarn.For more information, see /nowarn.
Optimize Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, active les optimisations du compilateur.If true, enables compiler optimizations. Ce paramètre correspond au commutateur /optimize du compilateur vbc.exe.This parameter corresponds to the /optimize switch of the vbc.exe compiler.
OptionCompare Paramètre String facultatif.Optional String parameter.

Spécifie la façon dont sont effectuées les comparaisons de chaînes.Specifies how string comparisons are made. Ce paramètre peut avoir les valeurs suivantes :This parameter can have the following values:

- binary
- text

La valeur binary indique que la tâche utilise des comparaisons de chaînes binaires.The value binary specifies that the task uses binary string comparisons. La valeur text indique que la tâche utilise des comparaisons de chaînes de texte.The value text specifies that the task uses text string comparisons. La valeur par défaut de ce paramètre est binary.The default value of this parameter is binary. Ce paramètre correspond au commutateur /optioncompare du compilateur vbc.exe.This parameter corresponds to the /optioncompare switch of the vbc.exe compiler.
OptionExplicit Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, les variables doivent être déclarées de manière explicite.If true, explicit declaration of variables is required. Ce paramètre correspond au commutateur /optionexplicit du compilateur vbc.exe.This parameter corresponds to the /optionexplicit switch of the vbc.exe compiler.
OptionInfer Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, autorise l’inférence de type des variables.If true, allows type inference of variables.
OptionStrict Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, la tâche applique la sémantique de type stricte pour restreindre les conversions de types implicites.If true, the task enforces strict type semantics to restrict implicit type conversions. Ce paramètre correspond au commutateur /optionstrict du compilateur vbc.exe.This parameter corresponds to the /optionstrict switch of the vbc.exe compiler.
OptionStrictType Paramètre String facultatif.Optional String parameter.

Spécifie quelle sémantique de type stricte génère un avertissement.Specifies which strict type semantics generate a warning. Actuellement, seul « custom » est pris en charge.Currently, only "custom" is supported. Ce paramètre correspond au commutateur /optionstrict du compilateur vbc.exe.This parameter corresponds to the /optionstrict switch of the vbc.exe compiler.
OutputAssembly Paramètre de sortie String facultatif.Optional String output parameter.

Spécifie le nom du fichier de sortie.Specifies the name of the ouput file. Ce paramètre correspond au commutateur /out du compilateur vbc.exe.This parameter corresponds to the /out switch of the vbc.exe compiler.
Platform Paramètre String facultatif.Optional String parameter.

Spécifie la plateforme de processeur ciblée par le fichier de sortie.Specifies the processor platform to be targeted by the output file. Ce paramètre peut avoir la valeur x86, x64, Itanium ou anycpu.This parameter can have a value of x86, x64, Itanium, or anycpu. La valeur par défaut est anycpu.Default is anycpu. Ce paramètre correspond au commutateur /platform du compilateur vbc.exe.This parameter corresponds to the /platform switch of the vbc.exe compiler.
References Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Provoque l’importation par la tâche des informations de type public dans le projet actuel à partir des éléments spécifiés.Causes the task to import public type information from the specified items into the current project. Ce paramètre correspond au commutateur /reference du compilateur vbc.exe.This parameter corresponds to the /reference switch of the vbc.exe compiler.
RemoveIntegerChecks Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, désactive les contrôles d’erreur de dépassement sur les entiers.If true, disables integer overflow error checks. La valeur par défaut est false.The default value is false. Ce paramètre correspond au commutateur /removeintchecks du compilateur vbc.exe.This parameter corresponds to the /removeintchecks switch of the vbc.exe compiler.
Resources Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Incorpore une ressource .NET Framework dans le fichier de sortie.Embeds a .NET Framework resource into the output file. Ce paramètre correspond au commutateur /resource du compilateur vbc.exe.This parameter corresponds to the /resource switch of the vbc.exe compiler.
ResponseFiles Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Spécifie le fichier réponse qui contient les commandes correspondant à cette tâche.Specifies the response file that contains commands for this task. Ce paramètre correspond à l’option @ (Spécifier un fichier réponse) du compilateur vbc.exe.This parameter corresponds to the @ (Specify Response File) option of the vbc.exe compiler.
RootNamespace Paramètre String facultatif.Optional String parameter.

Spécifie l’espace de noms racine pour toutes les déclarations de type.Specifies the root namespace for all type declarations. Ce paramètre correspond au commutateur /rootnamespace du compilateur vbc.exe.This parameter corresponds to the /rootnamespace switch of the vbc.exe compiler.
SdkPath Paramètre String facultatif.Optional String parameter.

Spécifie l'emplacement de mscorlib.dll et de microsoft.visualbasic.dll.Specifies the location of mscorlib.dll and microsoft.visualbasic.dll. Ce paramètre correspond au commutateur /sdkpath du compilateur vbc.exe.This parameter corresponds to the /sdkpath switch of the vbc.exe compiler.
Sources Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Spécifie un ou plusieurs fichiers sources Visual BasicVisual Basic.Specifies one or more Visual BasicVisual Basic source files.
TargetCompactFramework Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, la tâche cible le .NET Compact Framework.NET Compact Framework.If true, the task targets the .NET Compact Framework.NET Compact Framework. Cette option correspond au commutateur /netcf du compilateur vbc.exe.This switch corresponds to the /netcf switch of the vbc.exe compiler.
TargetType Paramètre String facultatif.Optional String parameter.

Spécifie le format de fichier du fichier de sortie.Specifies the file format of the output file. Ce paramètre peut avoir la valeur library, qui crée une bibliothèque de codes, exe, qui crée une application console, module, qui crée un module, ou winexe, qui crée un programme Windows.This parameter can have a value of library, which creates a code library, exe, which creates a console application, module, which creates a module, or winexe, which creates a Windows program. La valeur par défaut est library.Default is library. Ce paramètre correspond au commutateur /target du compilateur vbc.exe.This parameter corresponds to the /target switch of the vbc.exe compiler.
Timeout Paramètre Int32 facultatif.Optional Int32 parameter.

Spécifie le délai, en millisecondes, après lequel l’exécutable de la tâche est arrêté.Specifies the amount of time, in milliseconds, after which the task executable is terminated. La valeur par défaut est Int.MaxValue, ce qui indique qu’il n’existe aucun délai d’expiration.The default value is Int.MaxValue, indicating that there is no time out period.
ToolPath Paramètre String facultatif.Optional String parameter.

Spécifie l’emplacement à partir duquel la tâche chargera le fichier exécutable sous-jacent (vbc.exe).Specifies the location from where the task will load the underlying executable file (vbc.exe). Si vous ne spécifiez pas ce paramètre, la tâche utilise le chemin d’installation du SDK correspondant à la version du framework qui exécute MSBuildMSBuild.If this parameter is not specified, the task uses the SDK installation path corresponding to the version of the framework that is running MSBuildMSBuild.
TreatWarningsAsErrors Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, tous les avertissements sont traités comme des erreurs.If true, all warnings are treated as errors. Pour plus d’informations, consultez /warnaserror (Visual Basic).For more information, see /warnaserror (Visual Basic).
UseHostCompilerIfAvailable Paramètre Boolean facultatif.Optional Boolean parameter.

Demande à la tâche d’utiliser l’objet de compilateur in-process s’il est disponible.Instructs the task to use the in-process compiler object, if available. Son utilisation est réservée à Visual StudioVisual Studio.Used only by Visual StudioVisual Studio.
Utf8Output Paramètre Boolean facultatif.Optional Boolean parameter.

Enregistre les résultats de la compilation au format d’encodage UTF-8.Logs compiler output using UTF-8 encoding. Ce paramètre correspond au commutateur /utf8output du compilateur vbc.exe.This parameter corresponds to the /utf8output switch of the vbc.exe compiler.
Verbosity Paramètre String facultatif.Optional String parameter.

Spécifie le niveau de commentaires de la sortie du compilateur.Specifies the verbosity of the compiler's output. Le niveau de commentaires peut être Quiet, Normal (la valeur par défaut) ou Verbose.Verbosity can be Quiet, Normal (the default), or Verbose.
WarningsAsErrors Paramètre String facultatif.Optional String parameter.

Spécifie une liste d'avertissements à traiter comme des erreurs.Specifies a list of warnings to treat as errors. Pour plus d’informations, consultez /warnaserror (Visual Basic).For more information, see /warnaserror (Visual Basic).

Ce paramètre remplace le paramètre TreatWarningsAsErrors.This parameter overrides the TreatWarningsAsErrors parameter.
WarningsNotAsErrors Paramètre String facultatif.Optional String parameter.

Spécifie une liste d'avertissements à ne pas traiter comme des erreurs.Specifies a list of warnings that are not treated as errors. Pour plus d’informations, consultez /warnaserror (Visual Basic).For more information, see /warnaserror (Visual Basic).

Ce paramètre est utile uniquement si le paramètre TreatWarningsAsErrors est défini sur true.This parameter is only useful if the TreatWarningsAsErrors parameter is set to true.
Win32Icon Paramètre String facultatif.Optional String parameter.

Insère un fichier .ico dans l’assembly, ce qui donne au fichier de sortie l’apparence souhaitée dans l’Explorateur de fichiers.Inserts an .ico file in the assembly, which gives the output file the desired appearance in File Explorer. Ce paramètre correspond au commutateur /win32icon du compilateur vbc.exe.This parameter corresponds to the /win32icon switch of the vbc.exe compiler.
Win32Resources Paramètre String facultatif.Optional String parameter.

Insère un fichier de ressources Win32 (.res) dans le fichier de sortie.Inserts a Win32 resource (.res) file in the output file. Ce paramètre correspond au commutateur /win32resource du compilateur vbc.exe.This parameter corresponds to the /win32resource switch of the vbc.exe compiler.

NotesRemarks

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe ToolTaskExtension, qui elle-même hérite de la classe ToolTask.In addition to the parameters listed above, this task inherits parameters from the ToolTaskExtension class, which itself inherits from the ToolTask class. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez l’article ToolTaskExtension Base Class (Classe de base ToolTaskExtension).For a list of these additional parameters and their descriptions, see ToolTaskExtension Base Class.

ExempleExample

L’exemple suivant compile un projet Visual BasicVisual Basic.The following example compiles a Visual BasicVisual Basic project.

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

Voir aussiSee Also

Compilateur de ligne de commande de Visual Basic Visual Basic Command-Line Compiler
Tâches Tasks
Task Reference (Informations de référence sur les tâches MSBuild)Task Reference