Partager via

Vbc (tâche)

  • Article

Encapsule vbc.exe, 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 Compilateur de ligne de commande de Visual Basic.

Paramètres

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

Paramètre Description
AdditionalLibPaths Paramètre String[] facultatif.

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

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. Ce paramètre correspond au commutateur -addmodule du compilateur vbc.exe.
BaseAddress Paramètre String facultatif.

Spécifie l’adresse de base de la DLL. Ce paramètre correspond au commutateur -baseaddress du compilateur vbc.exe.
CodePage Paramè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.
DebugType Paramètre String[] facultatif.

Fait en sorte que le compilateur génère des informations de débogage. Ce paramètre peut avoir les valeurs suivantes :

- full
- pdbonly

La valeur par défaut full, permet d’attacher un débogueur au programme en cours d’exécution. 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. Pour plus d’informations, consultez -debug (Visual Basic).
DefineConstants Paramètre String[] facultatif.

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

symbol1 value1 = ; symbol2 value2 =

Ce paramètre correspond au commutateur -define du compilateur vbc.exe.
DelaySign Paramè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 sauf s’il est utilisé avec le paramètre KeyFile ou KeyContainer. Ce paramètre correspond au commutateur -delaysign du compilateur vbc.exe.
Deterministic Paramètre Boolean facultatif.

Quand la valeur est true, indique au compilateur de générer un assembly dont le contenu binaire est identique dans les compilations si les entrées sont identiques.

Pour plus d’informations, consultez -deterministic.
DisabledWarnings Paramètre String facultatif.

Supprime les avertissements spécifiés. Vous avez besoin de spécifier uniquement la partie numérique de l’identificateur d’avertissement. Les différents avertissements sont séparés par des points-virgules. Ce paramètre correspond au commutateur -nowarn du compilateur vbc.exe.
DocumentationFile Paramètre String facultatif.

Traite les commentaires de documentation pour les diriger vers le fichier XML spécifié. Ce paramètre remplace l’attribut GenerateDocumentation. Pour plus d’informations, consultez -doc.
EmitDebugInformation Paramètre Boolean facultatif.

Si sa valeur est true, la tâche génère des informations de débogage et les place dans un fichier .pdb. Pour plus d’informations, consultez -debug (Visual Basic).
ErrorReport Paramètre String facultatif.

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

- 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.

Si vous spécifiez send 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. Elle signale les erreurs dans une sortie texte uniquement.

Ce paramètre correspond au commutateur -errorreport du compilateur vbc.exe.
FileAlignment Paramè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.
GenerateDocumentation Paramètre Boolean facultatif.

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. Pour plus d’informations, consultez -doc.
Imports Paramètre ITaskItem[] facultatif.

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.
KeyContainer Paramètre String facultatif.

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

Spécifie le nom du fichier contenant la clé de chiffrement. Pour plus d’informations, consultez -keyfile.
LangVersion Paramètre System.String facultatif.

Spécifie la version du langage, comme « 15.5 ».
LinkResources Paramètre ITaskItem[] facultatif.

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. Ce paramètre correspond au commutateur -linkresource du compilateur vbc.exe.
MainEntryPoint Paramè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.
ModuleAssemblyName Paramètre String facultatif.

Spécifie l’assembly dont ce module fait partie.
NoConfig Paramè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.
NoLogo Paramètre Boolean facultatif.

Si true, supprime l’affichage des informations de bannière du compilateur. Ce paramètre correspond au commutateur -nologo du compilateur vbc.exe.
NoStandardLib Paramètre Boolean facultatif.

Configure le compilateur pour ne pas référencer les bibliothèques standard. Ce paramètre correspond au commutateur -nostdlib du compilateur vbc.exe.
NoVBRuntimeReference Paramètre Boolean facultatif.

À usage interne uniquement Si sa valeur est True, empêche la référence automatique à Microsoft.VisualBasic.dll.
NoWarnings Paramètre Boolean facultatif.

Si la valeur est true, la tâche supprime tous les avertissements. Pour plus d’informations, consultez -nowarn.
Optimize Paramètre Boolean facultatif.

Si la valeur est true, active les optimisations du compilateur. Ce paramètre correspond au commutateur -optimize du compilateur vbc.exe.
OptionCompare Paramè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 indique 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.
OptionExplicit Paramètre Boolean facultatif.

Si la valeur est true, les variables doivent être déclarées de manière explicite. Ce paramètre correspond au commutateur -optionexplicit du compilateur vbc.exe.
OptionInfer Paramètre Boolean facultatif.

Si la valeur est true, autorise l’inférence de type des variables.
OptionStrict Paramètre Boolean facultatif.

Si la valeur est true, la tâche applique la sémantique de type stricte pour restreindre les conversions de types implicites. Ce paramètre correspond au commutateur -optionstrict du compilateur vbc.exe.
OptionStrictType Paramè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.
OutputAssembly Paramètre de sortie String facultatif.

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

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

Provoque l’importation par la tâche des informations de type public dans le projet actuel à partir des éléments spécifiés. Ce paramètre correspond au commutateur -reference du compilateur vbc.exe.
RemoveIntegerChecks Paramètre Boolean facultatif.

Si la valeur est true, désactive les contrôles 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.
Resources Paramètre ITaskItem[] facultatif.

Incorpore une ressource .NET Framework dans le fichier de sortie. Ce paramètre correspond au commutateur -resource du compilateur vbc.exe.
ResponseFiles Paramètre ITaskItem[] facultatif.

Spécifie le fichier réponse qui contient les commandes correspondant à cette tâche. Ce paramètre correspond à l’option @ (Spécifier un fichier réponse) du compilateur vbc.exe.
RootNamespace Paramè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.
SdkPath Paramè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.
Sources Paramètre ITaskItem[] facultatif.

Spécifie un ou plusieurs fichiers source Visual Basic.
TargetCompactFramework Paramètre Boolean facultatif.

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

Spécifie le format de fichier du fichier de sortie. 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. La valeur par défaut est library. Ce paramètre correspond au commutateur -target du compilateur vbc.exe.
Timeout Paramètre Int32 facultatif.

Spécifie le délai, en millisecondes, après lequel l’exécutable de la tâche est arrêté. La valeur par défaut est Int.MaxValue, ce qui indique qu’il n’existe aucun délai d’expiration.
ToolPath Paramètre String facultatif.

Spécifie l’emplacement à partir duquel la tâche chargera le fichier exécutable sous-jacent (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 MSBuild.
TreatWarningsAsErrors Paramètre Boolean facultatif.

Si la valeur est true, tous les avertissements sont traités comme des erreurs. Pour plus d’informations, consultez -warnaserror (Visual Basic).
UseHostCompilerIfAvailable Paramètre Boolean facultatif.

Demande à la tâche d’utiliser l’objet de compilateur in-process s’il est disponible. Utilisé uniquement par Visual Studio.
Utf8Output Paramètre Boolean facultatif.

Enregistre les résultats de la compilation au format d’encodage UTF-8. Ce paramètre correspond au commutateur -utf8output du compilateur vbc.exe.
Verbosity Paramètre String facultatif.

Spécifie le niveau de commentaires de la sortie du compilateur. Le niveau de commentaires peut être Quiet, Normal (la valeur par défaut) ou Verbose.
WarningsAsErrors Paramètre String facultatif.

Spécifie une liste d'avertissements à traiter comme des erreurs. Pour plus d’informations, consultez -warnaserror (Visual Basic).

Ce paramètre remplace le paramètre TreatWarningsAsErrors.
WarningsNotAsErrors Paramètre String facultatif.

Spécifie une liste d'avertissements à ne pas traiter comme des erreurs. Pour plus d’informations, consultez -warnaserror (Visual Basic).

Ce paramètre est utile uniquement si le paramètre TreatWarningsAsErrors est défini sur true.
Win32Icon Paramètre String facultatif.

Insère un fichier .ico dans l’assembly, ce 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.
Win32Resources Paramè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.

Paramètres ToolTaskExtension

Cette tâche hérite de la classe ToolTaskExtension, laquelle hérite de la classe ToolTask, qui hérite elle-même de la classe Task. Cette chaîne d'héritage ajoute plusieurs paramètres aux tâches qui en dérivent.

Le tableau ci-dessous décrit les paramètres des classes de base :

Paramètre Description
EchoOff Paramètre bool facultatif.

Quand la valeur est true, cette tâche passe /Q à la ligne de commande cmd.exe de telle manière que cette dernière ne soit pas copiée dans stdout.
EnvironmentVariables Paramètres de tableau String facultatif.

Tableau de définitions de variables d’environnement, séparées par des points-virgules. Chaque définition devrait spécifier un nom et une valeur de variable d’environnement séparés par un signe égal. Ces variables sont transmises à l'exécutable généré en plus ou en remplacement sélectif du bloc environnement normal. Par exemple : Variable1=Value1;Variable2=Value2.
ExitCode Paramètre en lecture seule de sortie Int32 facultatif.

Spécifie le code de sortie fourni par la commande exécutée. Si la tâche a journalisé des erreurs, alors que le processus avait un code de sortie de 0 (réussite), ce paramètre prend la valeur -1.
LogStandardErrorAsError Paramètre bool facultatif.

Si la valeur est true, tous les messages reçus sur le flux d'erreur standard sont journalisés en tant qu'erreurs.
StandardErrorImportance Paramètre String facultatif.

Importance avec laquelle le texte doit être enregistré dans le flux d’erreur standard.
StandardOutputImportance Paramètre String facultatif.

Importance avec laquelle le texte doit être enregistré dans le flux de sortie standard.
Timeout Paramètre Int32 facultatif.

Spécifie le délai, en millisecondes, après lequel l’exécutable de la tâche est arrêté. La valeur par défaut est Int.MaxValue, ce qui indique qu’il n’existe aucun délai d’expiration. Délai d’expiration en millisecondes.
ToolExe Paramètre string facultatif.

Les projets peuvent l'implémenter pour remplacer un ToolName. Les tâches peuvent le remplacer pour préserver le ToolName.
ToolPath Paramètre string facultatif.

Spécifie l’emplacement à partir duquel la tâche charge le fichier exécutable sous-jacent. Si ce paramètre n'est pas spécifié, la tâche utilise le chemin d'installation du SDK qui correspond à la version de l'infrastructure qui exécute MSBuild.
UseCommandProcessor Paramètre bool facultatif.

Quand la valeur est true, cette tâche crée un fichier de commandes pour la ligne de commande et l'exécute à l'aide de l'interpréteur de commandes au lieu d'exécuter la commande directement.
YieldDuringToolExecution Paramètre bool facultatif.

Quand la valeur est true, cette tâche donne le nœud quand sa tâche s'exécute.

Exemple

L’exemple suivant compile un projet Visual Basic.

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

Voir aussi