Csc (tâche)

Encapsulecsc.exe et produit des fichiers exécutables (.exe), des bibliothèques de liens dynamiques (.dll) ou des modules de code (.netmodule). Pour plus d’informations sur csc.exe, consultez Options du compilateur C#.

Paramètres

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

Paramètre	Description
AdditionalLibPaths	Paramètre String[] facultatif. Spécifie des répertoires supplémentaires dans lesquels rechercher des références. Pour plus d’informations, consultez -lib (options du compilateur C#).
AddModules	Paramètre String facultatif. Spécifie un ou plusieurs modules à inclure dans cet assembly. Pour plus d’informations, consultez -addmodule (options du compilateur C#).
AllowUnsafeBlocks	Paramètre Boolean facultatif. Si true, compile le code qui utilise le mot clé unsafe. Pour plus d’informations, consultez -unsafe (options du compilateur C#).
ApplicationConfiguration	Paramètre String facultatif. Spécifie le fichier de configuration de l’application contenant les paramètres de liaison d’assembly.
BaseAddress	Paramètre String facultatif. Spécifie l'adresse de base préférée à laquelle charger une DLL. L’adresse de base par défaut d’une DLL est définie par le Common Language Runtime (CLR) .NET Framework. Pour plus d’informations, consultez -baseaddress (options du compilateur C#).
CheckForOverflowUnderflow	Paramètre Boolean facultatif. Indique si l’arithmétique sur les entiers qui dépasse les limites du type de données entraîne une exception au moment de l’exécution. Pour plus d’informations, consultez -checked (options du compilateur C#).
ChecksumAlgorithm	Paramètre String facultatif. Spécifie l'algorithme de calcul de la somme de contrôle du fichier source stockée dans le fichier PDB. L’algorithme doit être SHA1 (par défaut) ou SHA256. Voir ChecksumAlgorithm.
CodeAnalysisRuleset	Paramètre String facultatif. Spécifie un fichier ruleset qui désactive des diagnostics spécifiques. Voir CodeAnalysisRuleset.
CodePage	Paramètre Int32 facultatif. Spécifie la page de codes à utiliser pour tous les fichiers de code source inclus dans la compilation. Pour plus d’informations, consultez -codepage (options du compilateur C#).
DebugType	Paramètre String facultatif. Spécifie le type de débogage. DebugType peut avoir la valeur full ou pdbonly. La valeur par défaut est full, ce qui permet d’attacher un débogueur à un programme en cours d’exécution. La spécification de pdbonly active le débogage du code source lorsque le programme est démarré dans le débogueur, mais affiche uniquement un assembleur lorsque le programme en cours d’exécution est attaché au débogueur. Ce paramètre remplace le paramètre EmitDebugInformation. Pour plus d’informations, consultez -debug (options du compilateur C#).
DefineConstants	Paramètre String facultatif. Définit les symboles du préprocesseur. Pour plus d’informations, consultez -define (options du compilateur C#).
DelaySign	Paramètre Boolean facultatif. Si true, indique que vous souhaitez placer uniquement la clé publique dans l’assembly. Si false, indique que vous souhaitez obtenir un assembly complètement signé Ce paramètre n’a aucun effet, sauf s’il est utilisé avec les paramètres KeyFile ou KeyContainer. Pour plus d’informations, consultez -delaysign (options du compilateur C#).
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 (options du compilateur C#).
DisabledWarnings	Paramètre String facultatif. Spécifie la liste d’avertissements à désactiver. Pour plus d’informations, consultez -nowarn (options du compilateur C#).
DocumentationFile	Paramètre String facultatif. Traite les commentaires de documentation pour les diriger vers un fichier XML. Pour plus d’informations, consultez -doc (options du compilateur C#).
EmbedAllSources	Paramètre Boolean facultatif. Incorporer tous les fichiers sources du PDB. Pour plus d’informations, consultez -embed (options du compilateur C#).
EmitDebugInformation	Paramètre Boolean facultatif. Si true, la tâche génère des informations de débogage et les place dans un fichier de base de données du programme (.pdb). Si false, la tâche n’émet aucune information de débogage. La valeur par défaut est false. Pour plus d’informations, consultez -debug (options du compilateur C#).
ErrorLog	Paramètre String facultatif. Spécifie un fichier pour journaliser tous les diagnostics du compilateur et de l’analyseur. Voir ErrorLog.
ErrorReport	Paramètre String facultatif. Fournit un moyen pratique de signaler une erreur interne C# à Microsoft. Ce paramètre peut avoir la valeur prompt, send ou none. Si le paramètre est défini sur prompt, vous recevez une invite lorsqu’une erreur interne du compilateur se produit. Cette invite vous permet d’envoyer un rapport de bogue par voie électronique à Microsoft. Si le paramètre est défini sur send, un rapport de bogue est automatiquement envoyé. Si le paramètre est défini sur none, l’erreur est signalée uniquement dans la sortie de texte du compilateur. La valeur par défaut est none. Pour plus d’informations, consultez -errorreport (options du compilateur C#).
FileAlignment	Paramètre Int32 facultatif. Spécifie la taille des sections dans le fichier de sortie. Pour plus d’informations, consultez -filealign (options du compilateur C#).
GenerateFullPaths	Paramètre Boolean facultatif. Si true, spécifie le chemin d’accès absolu au fichier dans la sortie du compilateur. Si false, spécifie le nom du fichier. La valeur par défaut est false. Pour plus d’informations, consultez -fullpaths (options du compilateur C#).
HighEntropyVA	Paramètre Boolean facultatif. Activez la randomisation du layout de l’espace d’adressage haute entropie (ASLR). Voir HighEntropyVA.
KeyContainer	Paramètre String facultatif. Spécifie le nom du conteneur de la clé de chiffrement. Pour plus d’informations, consultez -keycontainer (options du compilateur C#).
KeyFile	Paramètre String facultatif. Spécifie le nom du fichier contenant la clé de chiffrement. Pour plus d’informations, consultez -keyfile (options du compilateur C#).
LangVersion	Paramètre String facultatif. Spécifie la version du langage à utiliser. Pour plus d’informations, consultez -langversion (options du compilateur C#).
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. Les éléments transmis dans ce paramètre peuvent posséder des entrées de métadonnées facultatives nommées LogicalName et Access. LogicalName correspond au paramètre identifier du commutateur /linkresource, et Access correspond au paramètre accessibility-modifier. Pour plus d’informations, consultez -linkresource (options du compilateur C#).
MainEntryPoint	Paramètre String facultatif. Spécifie l’emplacement de la méthode Main. Pour plus d’informations, consultez -main (options du compilateur C#).
ModuleAssemblyName	Paramètre String facultatif. Spécifie le nom de l’assembly dont ce module doit faire partie.
NoConfig	Paramètre Boolean facultatif. Si la valeur est true, indique au compilateur de ne pas compiler avec le fichier csc.rsp. Pour plus d’informations, consultez -noconfig (options du compilateur C#).
NoLogo	Paramètre Boolean facultatif. Si true, supprime l’affichage des informations de bannière du compilateur. Pour plus d’informations, consultez -nologo (options du compilateur C#).
NoStandardLib	Paramètre Boolean facultatif. Si sa valeur est true, empêche l’importation de mscorlib.dll, qui définit la totalité de l’espace de noms système. Utilisez ce paramètre si vous souhaitez définir ou créer vos propres objets et espace de noms système. Pour plus d’informations, consultez -nostdlib (options du compilateur C#).
NoWin32Manifest	Paramètre Boolean facultatif. Si true, n’inclut pas le manifeste Win32 par défaut.
Nullable	Paramètre String facultatif. Spécifie le contexte nullable. L’argument doit être l’un des arguments enable, disable, warnings ou annotations. Voir Nullable.
Optimize	Paramètre Boolean facultatif. Si true, active les optimisations. Si false, désactive les optimisations. Pour plus d’informations, consultez -optimize (options du compilateur C#).
OutputAssembly	Paramètre de sortie String facultatif. Spécifie le nom du fichier de sortie. Pour plus d’informations, consultez -out (options du compilateur C#).
OutputRefAssembly	Paramètre String facultatif. Spécifie le nom du fichier d’assembly de la référence de sortie. Pour plus d’informations, consultez -refout (options du compilateur C#).
PathMap	Paramètre String facultatif. Valeur qui indique comment mapper les chemins d’accès physiques avec les noms de chemins d’accès sources générés en sortie par le compilateur. Voir PathMap.
PdbFile	Paramètre String facultatif. Spécifie le nom de fichier des informations de débogage. Le nom par défaut est le nom du fichier de sortie avec l’extension .pdb.
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 ou anycpu. La valeur par défaut est anycpu. Pour plus d’informations, consultez -platform (options du compilateur C#).
PreferredUILang	Paramètre String facultatif. Spécifie la langue dans laquelle le compilateur C# affiche la sortie, comme les messages d’erreur. Voir PreferredUILang.
PublicSign	Paramètre Boolean facultatif. Signez publiquement l’assembly de sortie. Voir PublicSign.
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. Pour plus d’informations, consultez -reference (options du compilateur C#). Vous pouvez spécifier un alias de référence C# dans un fichier MSBuild en ajoutant les métadonnées Aliases à l’élément « Reference » d’origine. Par exemple, pour définir l’alias « LS1 » dans la ligne de commande CSC suivante : CSC /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs Vous devez utiliser : <Reference Include="MyCodeLibrary"> <Aliases>LS1</Aliases> </Reference>
RefOnly	Paramètre Boolean facultatif. Produisez un assembly de référence, au lieu d’un assembly complet, en tant que sortie principale. Voir ProduceOnlyReferenceAssembly.
ReportAnalyzer	Paramètre Boolean facultatif. Créer un rapport sur les informations supplémentaires de l’analyseur, comme l’heure d’exécution. Voir ReportAnalyzer.
Resources	Paramètre ITaskItem[] facultatif. Incorpore une ressource .NET Framework dans le fichier de sortie. Les éléments transmis dans ce paramètre peuvent posséder des entrées de métadonnées facultatives nommées LogicalName et Access. LogicalName correspond au paramètre identifier du commutateur /resource, et Access correspond au paramètre accessibility-modifier. Pour plus d’informations, consultez -resource (options du compilateur C#).
ResponseFiles	Paramètre String facultatif. Spécifie le fichier réponse qui contient les commandes correspondant à cette tâche. Pour plus d’informations, consultez @ (Spécifier un fichier réponse).
Sources	Paramètre ITaskItem[] facultatif. Spécifie un ou plusieurs fichiers sources C#.
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. Pour plus d’informations, consultez -target (options du compilateur C#).
TreatWarningsAsErrors	Paramètre Boolean facultatif. Si true, traite tous les avertissements comme des erreurs. Pour plus d’informations, consultez -warnaserror (options du compilateur C#).
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. Pour plus d’informations, consultez -utf8output (options du compilateur C#).
WarningLevel	Paramètre Int32 facultatif. Spécifie le niveau d’avertissement que le compilateur doit afficher. Pour plus d’informations, consultez -warn (options du compilateur C#).
WarningsAsErrors	Paramètre String facultatif. Spécifie une liste d'avertissements à traiter comme des erreurs. Pour plus d’informations, consultez -warnaserror (options du compilateur C#). 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 (options du compilateur C#). 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. Pour plus d’informations, consultez -win32icon (options du compilateur C#).
Win32Manifest	Paramètre String facultatif. Spécifie le manifeste Win32 à inclure.
Win32Resource	Paramètre String facultatif. Insère un fichier de ressources Win32 (.res) dans le fichier de sortie. Pour plus d’informations, consultez -win32res (options du compilateur C#).

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 utilise la tâche Csc pour compiler un fichier exécutable à partir des fichiers sources de la collection d’éléments Compile.

<CSC
    Sources="@(Compile)"
    OutputAssembly="$(AppName).exe"
    EmitDebugInformation="true" />

Voir aussi

• Informations de référence sur les tâches
• Tâches