Attività Csc
Aggiornamento: novembre 2007
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 (specifica del percorso dei riferimenti agli assembly) (opzioni del compilatore C#). |
AddModules |
Parametro String facoltativo. Specifica uno o più moduli da inserire nell'assembly. Per ulteriori informazioni, vedere /addmodule (importazione di metadati) (opzioni del compilatore C#). |
AllowUnsafeBlocks |
Parametro Boolean facoltativo. Se true, compila il codice che utilizza la parola chiave unsafe. Per ulteriori informazioni, vedere /unsafe (attivare la modalità non protetta) (opzioni del compilatore C#). |
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 (specifica dell'indirizzo di base della DLL) (opzioni del compilatore C#). |
CheckForOverflowUnderflow |
Parametro Boolean facoltativo. Specifica l'eventuale generazione di un'eccezione in fase di esecuzione, qualora un'operazione aritmetica su valori integer causi un overflow dei limiti del tipo di dati. Per ulteriori informazioni, vedere /checked (controllo dei calcoli su valori integer) (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 (specifica della tabella codici per i file di codice sorgente) (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 (creazione delle informazioni di debug) (opzioni del compilatore C#). |
DefineConstants |
Parametro String facoltativo. Definisce i simboli del preprocessore. Per ulteriori informazioni, vedere /define (definizione del preprocessore) (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 (ritardare la firma di un assembly) (opzioni del compilatore C#). |
DisabledWarnings |
Parametro String facoltativo. Specifica l'elenco di avvisi da disattivare. Per ulteriori informazioni, vedere /nowarn (disattivazione degli avvisi specificati) (opzioni del compilatore C#). |
DocumentationFile |
Parametro String facoltativo. Elabora i commenti relativi alla documentazione in un file XML. Per ulteriori informazioni, vedere /doc (elaborazione dei commenti per la documentazione) (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 (creazione delle informazioni di 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 (impostare il comportamento relativo alla segnalazione degli errori) (opzioni del compilatore C#). |
FileAlignment |
Parametro Int32 facoltativo. Specifica le dimensioni delle sezioni nel file di output. Per ulteriori informazioni, vedere /filealign (specifica dell'allineamento delle sezioni) (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 (specificare il percorso completo nell'output del compilatore) (opzioni del compilatore C#). |
KeyContainer |
Parametro String facoltativo. Specifica il nome del contenitore di chiavi di crittografia. Per ulteriori informazioni, vedere /keycontainer (specificare il contenitore di chiavi con nome sicuro) (opzioni del compilatore C#). |
KeyFile |
Parametro String facoltativo. Specifica il nome del file contenente la chiave di crittografia. Per ulteriori informazioni, vedere /keyfile (specificare il file di chiave con nome sicuro) (opzioni del compilatore C#). |
LangVersion |
Parametro String facoltativo. Specifica la versione di linguaggio da utilizzare. Per ulteriori informazioni, vedere /langversion (sintassi conforme) (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 (collegamento a una risorsa di .NET Framework) (opzioni del compilatore C#). |
MainEntryPoint |
Parametro String facoltativo. Specifica il percorso del metodo Main. Per ulteriori informazioni, vedere /main (specifica della posizione del metodo Main) (opzioni del compilatore C#). |
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 (elusione di csc.rsp) (opzioni del compilatore C#). |
NoLogo |
Parametro Boolean facoltativo. Se il parametro è impostato su true, viene disattivata la visualizzazione dei messaggi informativi del compilatore. Per ulteriori informazioni, vedere /nologo (omissione dei messaggi informativi) (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 (omissione dell'importazione della libreria standard) (opzioni del compilatore C#). |
Optimize |
Parametro Boolean facoltativo. Se il parametro è impostato su true, le ottimizzazioni vengono attivate. Se è impostato su false, vengono disattivate. Per ulteriori informazioni, vedere /optimize (attivazione e disattivazione delle ottimizzazioni) (opzioni del compilatore C#). |
OutputAssembly |
Parametro di output String facoltativo. Specifica il nome del file di output. Per ulteriori informazioni, vedere /out (impostazione del nome del file di output) (opzioni del compilatore C#). |
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 (specifica della piattaforma di output) (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 (importazione di metadati) (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 (incorporazione di un file di risorse nel file di output) (opzioni del compilatore C#). |
ResponseFiles |
Parametro String facoltativo. Specifica il file di risposta che contiene i comandi per questa attività. Per ulteriori informazioni, vedere @ (specifica del file di risposta) (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 (specifica del formato del file di output) (opzioni del compilatore C#). |
Timeout |
Parametro Int32 facoltativo. Specifica l'intervallo di tempo, in millisecondi, al termine del quale l'eseguibile dell'attività viene interrotto. Il valore predefinito è Int.MaxValue, con cui viene indicato che non è stato specificato alcun periodo di timeout. |
ToolPath |
Parametro String facoltativo. Specifica il percorso da cui l'attività carica il file eseguibile sottostante (CSC.exe). Se questo parametro non è specificato, viene utilizzato il percorso di installazione SDK corrispondente alla versione del framework che esegue MSBuild. |
TreatWarningsAsErrors |
Parametro Boolean facoltativo. Se il parametro è impostato su true, tutti gli avvisi vengono considerati come errori. Per ulteriori informazioni, vedere /warnaserror (gestione degli avvisi come errori) (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 (visualizzazione dei messaggi del compilatore con UTF-8) (opzioni del compilatore C#). |
WarningLevel |
Parametro Int32 facoltativo. Specifica il livello di avviso da visualizzare. Per ulteriori informazioni, vedere /warn (specifica del livello di avviso) (opzioni del compilatore C#). |
WarningsAsErrors |
Parametro String facoltativo. Specifica un elenco di avvisi da considerare come errori. Per ulteriori informazioni, vedere /warnaserror (gestione degli avvisi come errori) (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 (gestione degli avvisi come errori) (opzioni del compilatore C#). Questo parametro risulta utile solo se il parametro TreatWarningsAsErrors è impostato su true. |
WarningLevel |
Parametro Int32 facoltativo. Imposta il livello di avviso appropriato, compreso tra 0 e 4. Per ulteriori informazioni, vedere /warn (specifica del livello di avviso) (opzioni del compilatore C#). |
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 (importazione di un file ICO) (opzioni del compilatore C#). |
Win32Resource |
Parametro String facoltativo. Inserisce un file di risorse Win32 (res) nel file di output. Per ulteriori informazioni, vedere /win32res (importazione di un file di risorse Win32) (opzioni del compilatore C#). |
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" />