Csc, tâche
Inclut CSC.exe dans un wrapper et produit des fichiers exécutables (fichiers .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 (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 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 (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 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 (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 (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 (Options du compilateur C#). |
DebugType |
Paramètre String facultatif. Spécifie le type de débogage. DebugType peut être 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 (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. 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 (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#). |
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 (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 (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 (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 (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 (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 (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 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 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 fera partie. |
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 (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 (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 (Options du compilateur C#). |
NoWin32Manifest |
Paramètre Boolean facultatif. Si la valeur est true, ne pas inclure le manifeste Win32 par défaut. |
Optimize |
Paramètre Boolean facultatif. La valeur true active des optimisations. La valeur false désactive des 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#). |
PdbFile |
Paramètre String facultatif. Spécifie le nom de fichier des informations de débogage. Le nom par défaut est le nom de fichier de sortie avec une extension .pdb. |
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 (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 (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 : vous utiliseriez : |
Resources |
Paramètre ITaskItem[] optionnel. .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 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 pour cette tâche. Pour plus d'informations, consultez @ (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 (Options du compilateur C#). |
TreatWarningsAsErrors |
Paramètre Boolean facultatif. Si la valeur est true, considère tous les avertissements comme des erreurs. Pour plus d'informations, consultez /warnaserror (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 encodage UTF-8. Pour plus d'informations, consultez /utf8output (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 (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 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 (Options du compilateur C#). Ce paramètre n'est utile que lorsque la propriété TreatWarningsAsErrors a la valeur true. |
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 (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#). |
Notes
En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe Microsoft.Build.Tasks.ManagedCompiler, qui hérite elle-même 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 Classe de base ToolTaskExtension.
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" />