Attività Csc
Esegue il wrapping di CSC.exe e genera file eseguibili con estensione exe, librerie a collegamento dinamico con estensione dll o moduli di codice (con estensione netmodule). Per ulteriori informazioni su CSC.exe, vedere Opzioni del compilatore C#.
Parametri
Nella tabella riportata di seguito sono descritti i parametri dell'attività Csc.
Parametro |
Descrizione |
|---|---|
AdditionalLibPaths |
Parametro String[] facoltativo. Specifica le directory aggiuntive in cui eseguire la ricerca dei riferimenti. Per ulteriori informazioni, vedere /lib (opzioni del compilatore C#). |
AddModules |
Parametro String facoltativo. Specifica uno o più moduli da inserire nell'assembly. Per ulteriori informazioni, vedere /addmodule (opzioni del compilatore C#). |
AllowUnsafeBlocks |
Parametro Boolean facoltativo. Se true, compila il codice che utilizza la parola chiave unsafe. Per ulteriori informazioni, vedere /unsafe (opzioni del compilatore C#). |
ApplicationConfiguration |
Parametro String facoltativo. Specifica il file di configurazione dell'applicazione contenente le impostazioni di associazione dell'assembly. |
BaseAddress |
Parametro String facoltativo. Specifica l'indirizzo di base preferenziale per il caricamento di una DLL. L'indirizzo di base predefinito per una DLL viene impostato da Common Language Runtime di .NET Framework. Per ulteriori informazioni, vedere /baseaddress (opzioni del compilatore C#). |
CheckForOverflowUnderflow |
Parametro Boolean facoltativo. Specifica l'eventuale generazione di un'eccezione in fase di esecuzione, qualora un'operazione aritmetica su interi causi un overflow dei limiti del tipo di dati. Per ulteriori informazioni, vedere /checked (opzioni del compilatore C#). |
CodePage |
Parametro Int32 facoltativo. Specifica la tabella codici da utilizzare per tutti i file di codice sorgente inclusi nella compilazione. Per ulteriori informazioni, vedere /codepage (opzioni del compilatore C#). |
DebugType |
Parametro String facoltativo. Specifica il tipo di debug. DebugType può essere full o pdbonly. Il valore predefinito è full, che consente di associare un debugger a un programma in esecuzione. La specifica di pdbonly consente il debug del codice sorgente quando l'avvio del programma avviene dal debugger, ma in questo caso l'assembler viene visualizzato solo quando il programma in esecuzione è collegato al debugger. Questo parametro esegue l'override del parametro EmitDebugInformation. Per ulteriori informazioni, vedere /debug (opzioni del compilatore C#). |
DefineConstants |
Parametro String facoltativo. Definisce i simboli del preprocessore. Per ulteriori informazioni, vedere /define (opzioni del compilatore C#). |
DelaySign |
Parametro Boolean facoltativo. Se il parametro è impostato su true, specifica che si desidera ottenere un assembly firmato completamente. Se è impostato su false, specifica che si desidera inserire nell'assembly solo la chiave pubblica. Questo parametro ha effetto soltanto se viene utilizzato con il parametro KeyFile o KeyContainer. Per ulteriori informazioni, vedere /delaysign (opzioni del compilatore C#). |
DisabledWarnings |
Parametro String facoltativo. Specifica l'elenco di avvisi da disabilitare. Per ulteriori informazioni, vedere /nowarn (opzioni del compilatore C#). |
DocumentationFile |
Parametro String facoltativo. Elabora i commenti relativi alla documentazione in un file XML. Per ulteriori informazioni, vedere /doc (opzioni del compilatore C#). |
EmitDebugInformation |
Parametro Boolean facoltativo. Se il parametro è impostato su true, le informazioni di debug vengono generate e inserite in un file del database di programma (pdb). Se è impostato su false, non vengono generate informazioni di debug. Il valore predefinito è false. Per ulteriori informazioni, vedere /debug (opzioni del compilatore C#). |
ErrorReport |
Parametro String facoltativo. Consente di segnalare a Microsoft un errore interno C#. Il parametro può essere impostato su prompt, send o none. Se il parametro è impostato su prompt, si riceverà una richiesta quando si verifica un errore del compilatore interno. La richiesta consente di inviare elettronicamente una segnalazione dei bug a Microsoft. La segnalazione dei bug viene inviata automaticamente se il parametro è impostato su send. Se il parametro viene impostato su none, l'errore sarà segnalato soltanto nell'output di testo del compilatore. Il valore predefinito è none. Per ulteriori informazioni, vedere /errorreport (opzioni del compilatore C#). |
FileAlignment |
Parametro Int32 facoltativo. Specifica le dimensioni delle sezioni nel file di output. Per ulteriori informazioni, vedere /filealign (opzioni del compilatore C#). |
GenerateFullPaths |
Parametro Boolean facoltativo. Se il parametro è impostato su true, specifica il percorso assoluto del file nell'output del compilatore. Se è impostato su false, specifica il nome del file. Il valore predefinito è false. Per ulteriori informazioni, vedere /fullpaths (opzioni del compilatore C#). |
KeyContainer |
Parametro String facoltativo. Specifica il nome del contenitore di chiavi di crittografia. Per ulteriori informazioni, vedere /keycontainer (opzioni del compilatore C#). |
KeyFile |
Parametro String facoltativo. Specifica il nome del file contenente la chiave di crittografia. Per ulteriori informazioni, vedere /keyfile (opzioni del compilatore C#). |
LangVersion |
Parametro String facoltativo. Specifica la versione di linguaggio da utilizzare. Per ulteriori informazioni, vedere /langversion (opzioni del compilatore C#). |
LinkResources |
Parametro ITaskItem[] facoltativo. Crea un collegamento a una risorsa .NET Framework nel file di output, ma il file di risorse non viene inserito nel file di output. Agli elementi passati a questo parametro è possibile associare metadati facoltativi denominati LogicalName e Access. LogicalName corrisponde al parametro identifier dell'opzione /linkresource, mentre Access corrisponde al parametro accessibility-modifier. Per ulteriori informazioni, vedere /linkresource (opzioni del compilatore C#). |
MainEntryPoint |
Parametro String facoltativo. Specifica il percorso del metodo Main. Per ulteriori informazioni, vedere /main (opzioni del compilatore C#). |
ModuleAssemblyName |
Parametro String facoltativo. Specifica il nome dell'assembly che conterrà questo modulo. |
NoConfig |
Parametro Boolean facoltativo. Se il parametro è impostato su true, indica al compilatore di non eseguire la compilazione con il file csc.rsp. Per ulteriori informazioni, vedere /noconfig (opzioni del compilatore C#). |
NoLogo |
Parametro Boolean facoltativo. Se il parametro è impostato su true, viene disabilitata la visualizzazione dei messaggi informativi del compilatore. Per ulteriori informazioni, vedere /nologo (opzioni del compilatore C#). |
NoStandardLib |
Parametro Boolean facoltativo. Se il parametro è impostato su true, viene impedita l'importazione della libreria mscorlib.dll, che definisce l'intero spazio dei nomi System. Utilizzare questo parametro se si desidera definire o creare oggetti e uno spazio dei nomi System personalizzati. Per ulteriori informazioni, vedere /nostdlib (opzioni del compilatore C#). |
NoWin32Manifest |
Parametro Boolean facoltativo. Se true, non includere il manifesto Win32 predefinito. |
Optimize |
Parametro Boolean facoltativo. Se il parametro è impostato su true, le ottimizzazioni vengono attivate. Se è impostato su false, vengono disabilitate. Per ulteriori informazioni, vedere /optimize (opzioni del compilatore C#). |
OutputAssembly |
Parametro di output String facoltativo. Specifica il nome del file di output. Per ulteriori informazioni, vedere /out (opzioni del compilatore C#). |
PdbFile |
Parametro String facoltativo. Specifica il nome file delle informazioni di debug. Il nome predefinito è il nome del file di output con estensione pdb. |
Platform |
Parametro String facoltativo. Specifica la piattaforma processore di destinazione del file di output. Il parametro può essere impostato su x86, x64 o anycpu. Il valore predefinito è anycpu. Per ulteriori informazioni, vedere /platform (opzioni del compilatore C#). |
References |
Parametro ITaskItem[] facoltativo. Determina l'importazione delle informazioni sui tipi pubblici dagli elementi specificati nel progetto corrente. Per ulteriori informazioni, vedere /reference (opzioni del compilatore C#). Per specificare un alias di riferimento Visual C# in un file MSBuild è possibile aggiungere l'elemento di metadati Aliases all'elemento "Reference" originale. Ad esempio, per impostare l'alias "LS1" nella riga di comando di CSC seguente: occorre utilizzare: |
Resources |
Parametro ITaskItem[] facoltativo. Incorpora una risorsa .NET Framework nel file di output. Agli elementi passati a questo parametro è possibile associare metadati facoltativi denominati LogicalName e Access. LogicalName corrisponde al parametro identifier dell'opzione /resource, mentre Access corrisponde al parametro accessibility-modifier. Per ulteriori informazioni, vedere /resource (opzioni del compilatore C#). |
ResponseFiles |
Parametro String facoltativo. Specifica il file di risposta che contiene i comandi per questa attività. Per ulteriori informazioni, vedere @ (opzioni del compilatore C#). |
Sources |
Parametro ITaskItem[] facoltativo. Specifica uno o più file di origine Visual C#. |
TargetType |
Parametro String facoltativo. Specifica il formato del file di output. Il parametro può essere impostato su library per la creazione di una libreria di codice, su exe per la creazione di un'applicazione console, su module per la creazione di un modulo oppure su winexe per la creazione di un'applicazione Windows. Il valore predefinito è library. Per ulteriori informazioni, vedere /target (opzioni del compilatore C#). |
TreatWarningsAsErrors |
Parametro Boolean facoltativo. Se il parametro è impostato su true, tutti gli avvisi vengono considerati come errori. Per ulteriori informazioni, vedere /warnaserror (opzioni del compilatore C#). |
UseHostCompilerIfAvailable |
Parametro Boolean facoltativo. Indica all'attività di utilizzare, se disponibile, l'oggetto compilatore in-process. Utilizzato solo da Visual Studio. |
Utf8Output |
Parametro Boolean facoltativo. Registra l'output del compilatore utilizzando la codifica UTF-8. Per ulteriori informazioni, vedere /utf8output (opzioni del compilatore C#). |
WarningLevel |
Parametro Int32 facoltativo. Specifica il livello di avviso da visualizzare. Per ulteriori informazioni, vedere /warn (opzioni del compilatore C#). |
WarningsAsErrors |
Parametro String facoltativo. Specifica un elenco di avvisi da considerare come errori. Per ulteriori informazioni, vedere /warnaserror (opzioni del compilatore C#). Questo parametro esegue l'override del parametro TreatWarningsAsErrors. |
WarningsNotAsErrors |
Parametro String facoltativo. Specifica un elenco di avvisi da non considerare come errori. Per ulteriori informazioni, vedere /warnaserror (opzioni del compilatore C#). Questo parametro risulta utile solo se il parametro TreatWarningsAsErrors è impostato su true. |
Win32Icon |
Parametro String facoltativo. Inserisce nell'assembly un file ico, che conferisce al file di output l'aspetto desiderato in Esplora risorse. Per ulteriori informazioni, vedere /win32icon (opzioni del compilatore C#). |
Win32Manifest |
Parametro String facoltativo. Specifica il manifesto Win32 da includere. |
Win32Resource |
Parametro String facoltativo. Inserisce un file di risorse Win32 (res) nel file di output. Per ulteriori informazioni, vedere /win32res (opzioni del compilatore C#). |
Note
Oltre ai parametri sopra elencati, questa attività eredita i parametri dalla classe Microsoft.Build.Tasks.ManagedCompiler, che eredita dalla classe ToolTaskExtension, che eredita dalla classe ToolTask. Per un elenco di tali parametri aggiuntivi e le relative descrizioni, vedere Classe di base ToolTaskExtension.
Esempio
Nell'esempio riportato di seguito l'attività Csc viene utilizzata per compilare un eseguibile dai file di origine dell'insieme di elementi Compile.
<CSC
Sources="@(Compile)"
OutputAssembly="$(AppName).exe"
EmitDebugInformation="true" />