Partager via

Csc, tâche

  • Article

Mise à jour : novembre 2007

Encapsule CSC.exe et génère des fichiers exécutables (.exe), des bibliothèques de liens dynamiques (fichiers .dll) ou des modules de code (fichiers .netmodule). Pour plus d'informations sur CSC.exe, consultez Options du compilateur C#.

Paramètres

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

Paramètre

Description

AdditionalLibPaths

Paramètre String[] facultatif.

Spécifie les répertoires supplémentaires à utiliser pour la recherche de références. Pour plus d'informations, consultez /lib (Spécifier les emplacements des références d'assembly) (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 (Importer les métadonnées) (Options du compilateur C#).

AllowUnsafeBlocks

Paramètre Boolean facultatif.

Si le paramètre a la valeur true, la tâche compile du code qui utilise le mot clé unsafe. Pour plus d'informations, consultez /unsafe (Activer le mode non sécurisé) (Options du compilateur C#).

BaseAddress

Paramètre String facultatif.

Spécifie l'adresse de base préférée à laquelle doit être chargée une DLL. L'adresse de base par défaut d'une DLL est définie par le Common Language Runtime du .NET Framework. Pour plus d'informations, consultez /baseaddress (Spécifier l'adresse de base de DLL) (Options du compilateur C#).

CheckForOverflowUnderflow

Paramètre Boolean facultatif.

Spécifie si une opération arithmétique sur des entiers dépassant les limites du type de données lève une exception au moment de l'exécution. Pour plus d'informations, consultez /checked (Contrôler les calculs arithmétiques sur les entiers) (Options du compilateur C#).

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 (Spécifier la page de codes pour les fichiers de code source) (Options du compilateur C#).

DebugType

Paramètre String facultatif.

Spécifie le type de débogage. DebugType peut avoir les valeurs full ou pdbonly. La valeur par défaut, full, permet d'attacher un débogueur à un programme en cours d'exécution. La spécification de l'argument 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.

Ce paramètre se substitue au paramètre EmitDebugInformation.

Pour plus d'informations, consultez /debug (Émettre des informations de débogage) (Options du compilateur C#).

DefineConstants

Paramètre String facultatif.

Définit les symboles du préprocesseur. Pour plus d'informations, consultez /define (Définition de préprocesseur) (Options du compilateur C#).

DelaySign

Paramètre Boolean facultatif.

La valeur true indique que vous souhaitez obtenir un assembly complètement signé. La valeur false spécifie que vous souhaitez uniquement placer la clé publique dans l'assembly.

Ce paramètre n'a aucun effet sauf lorsqu'il est utilisé avec le paramètre KeyFile ou KeyContainer.

Pour plus d'informations, consultez /delaysign (Temporiser la signature de l'assembly) (Options du compilateur C#).

DisabledWarnings

Paramètre String facultatif.

Spécifie la liste d'avertissements à désactiver. Pour plus d'informations, consultez /nowarn (Supprimer les avertissements spécifiés) (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 (Traiter les commentaires de documentation) (Options du compilateur C#).

EmitDebugInformation

Paramè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). Si la valeur est false, la tâche ne génère aucune information de débogage. La valeur par défaut est false. Pour plus d'informations, consultez /debug (Émettre des informations de débogage) (Options du compilateur C#).

ErrorReport

Paramètre String facultatif.

Fournit un moyen pratique de signaler à Microsoft une erreur interne C#. Ce paramètre peut avoir les valeurs prompt, send ou none. Si le paramètre a la valeur prompt, une invite s'affiche lors d'une erreur interne du compilateur. L'invite vous permet d'envoyer électroniquement un rapport de bogues à Microsoft. Si le paramètre a la valeur send, un rapport de bogues est automatiquement envoyé. Si le paramètre a la valeur none, l'erreur sera signalée uniquement dans la sortie texte du compilateur. La valeur par défaut est none. Pour plus d'informations, consultez /errorreport (Définir le comportement du rapport d'erreurs) (Options du compilateur C#).

FileAlignment

Paramètre Int32 facultatif.

Spécifie la taille des sections du fichier de sortie. Pour plus d'informations, consultez /filealign (Spécifier l'alignement des sections) (Options du compilateur C#).

GenerateFullPaths

Paramètre Boolean facultatif.

Si la valeur est true, spécifie le chemin d'accès absolu au fichier dans les résultats de la compilation. Si la valeur est false, spécifie le nom du fichier. La valeur par défaut est false. Pour plus d'informations, consultez /fullpaths (Spécifier le chemin qualifié complet dans les résultats de la compilation) (Options du compilateur C#).

KeyContainer

Paramètre String facultatif.

Spécifie le nom du conteneur de clé de chiffrement. Pour plus d'informations, consultez /keycontainer (Spécifier un conteneur de clé de nom fort) (Options du compilateur C#).

KeyFile

Paramètre String facultatif.

Spécifie le nom de fichier qui contient la clé de chiffrement. Pour plus d'informations, consultez /keyfile (Spécifier un fichier de clé de nom fort) (Options du compilateur C#).

LangVersion

Paramètre String facultatif.

Spécifie la version du langage à utiliser. Pour plus d'informations, consultez /langversion (Syntaxe conforme) (Options du compilateur C#).

LinkResources

Paramètre ITaskItem[] facultatif.

Crée un lien vers une ressource du .NET Framework dans le fichier de sortie ; le fichier de ressources n'est pas stocké dans le fichier de sortie.

Les éléments passés dans ce paramètre peuvent avoir des entrées de métadonnées facultatives appelé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 (Lien vers une ressource du .NET Framework) (Options du compilateur C#).

MainEntryPoint

Paramètre String facultatif.

Spécifie l'emplacement de la méthode Main. Pour plus d'informations, consultez /main (Spécifier l'emplacement de la méthode Main) (Options du compilateur C#).

NoConfig

Paramètre Boolean facultatif.

La valeur true indique au compilateur de ne pas utiliser le fichier csc.rsp pour la compilation. Pour plus d'informations, consultez /noconfig (Ignorer csc.rsp) (Options du compilateur C#).

NoLogo

Paramètre Boolean facultatif.

Si sa valeur est true, il supprime l'affichage d'informations sur la bannière du compilateur. Pour plus d'informations, consultez /nologo (Supprimer les informations de la bannière) (Options du compilateur C#).

NoStandardLib

Paramètre Boolean facultatif.

La valeur true empêche l'importation du fichier mscorlib.dll, qui définit tout l'espace de noms System. Utilisez ce paramètre si vous souhaitez définir ou créer vos propres objets et espace de noms System. Pour plus d'informations, consultez /nostdlib (Ne pas importer la bibliothèque standard) (Options du compilateur C#).

Optimize

Paramètre Boolean facultatif.

La valeur true active des optimisations. La valeur false désactive des optimisations. Pour plus d'informations, consultez /optimize (Activer ou désactiver des optimisations) (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 (Spécifier le nom du fichier de sortie) (Options du compilateur C#).

Platform

Paramè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 ou anycpu. La valeur par défaut est anycpu. Pour plus d'informations, consultez /platform (Spécifier la plate-forme de sortie) (Options du compilateur C#).

References

Paramètre ITaskItem[] facultatif.

Entraîne la tâche à importer des informations de type public à partir des éléments spécifiés dans le projet actif. Pour plus d'informations, consultez /reference (Importer les métadonnées) (Options du compilateur C#).

Vous pouvez spécifier un alias de référence Visual C# dans un fichier MSBuild en ajoutant les Aliases de métadonnées à l'élément « Reference » initial. 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 utiliseriez :

<Reference Include="MyCodeLibrary">
  <Aliases>LS1</Aliases>
</Reference>

Resources

Paramètre ITaskItem[] facultatif.

.NET Framework incorpore un fichier de ressources dans le fichier de sortie.

Les éléments passés dans ce paramètre peuvent avoir des entrées de métadonnées facultatives appelé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 (Incorporer un fichier de ressources dans le fichier de sortie) (Options du compilateur C#).

ResponseFiles

Paramètre String facultatif.

Spécifie le fichier réponse qui contient les commandes pour cette tâche. Pour plus d'informations, consultez @ (Spécifier un fichier réponse) (Options du compilateur C#).

Sources

Paramètre ITaskItem[] facultatif.

Spécifie un ou plusieurs fichiers sources Visual C#.

TargetType

Paramè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. Pour plus d'informations, consultez /target (Spécifier le format du fichier de sortie) (Options du compilateur C#).

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

TreatWarningsAsErrors

Paramètre Boolean facultatif.

Si la valeur est true, considère tous les avertissements comme des erreurs. Pour plus d'informations, consultez /warnaserror (Considérer les avertissements comme des erreurs) (Options du compilateur C#).

UseHostCompilerIfAvailable

Paramètre Boolean facultatif.

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

Utf8Output

Paramètre Boolean facultatif.

Affiche les résultats de la compilation en codage UTF-8. Pour plus d'informations, consultez /utf8output (Afficher les messages du compilateur dans le format UTF-8) (Options du compilateur C#).

WarningLevel

Paramètre Int32 facultatif.

Spécifie le niveau d'avertissement à afficher par le compilateur. Pour plus d'informations, consultez /warn (Spécifier le niveau d'avertissement) (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 (Considérer les avertissements comme des erreurs) (Options du compilateur C#).

Ce paramètre se substitue au 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 (Considérer les avertissements comme des erreurs) (Options du compilateur C#).

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

WarningLevel

Paramètre Int32 facultatif.

Définit le niveau d'avertissement approprié (de 0 à 4). Pour plus d'informations, consultez /warn (Spécifier le niveau d'avertissement) (Options du compilateur C#).

Win32Icon

Paramètre String facultatif.

Insère un fichier .ico dans l'assembly, ce qui donne au fichier de sortie l'aspect souhaité dans l'Explorateur Windows. Pour plus d'informations, consultez /win32icon (Importer un fichier .ico) (Options du compilateur C#).

Win32Resource

Paramètre String facultatif.

Insère un fichier de ressources Win32 (.res) dans le fichier de sortie. Pour plus d'informations, consultez /win32res (Importer un fichier de ressources Win32) (Options du compilateur C#).

Exemple

L'exemple suivant utilise la tâche Csc pour compiler un fichier exécutable à partir des fichiers sources dans la collection d'éléments Compile.

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

Voir aussi

Concepts

Tâches MSBuild

Autres ressources

Référence des tâches MSBuild