Condividi tramite

Attività Csc

  • Articolo

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.

Consente di specificare la tabella codici da utilizzare per tutti i file del codice sorgente 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.

Consente di definire 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 della 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 la posizione del metodo Main.Per ulteriori informazioni, vedere la classe /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:

csc /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs

occorre utilizzare:

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

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 un file di icona nell'assembly, che fornisce il file di output l'aspetto desiderato in Esplora file.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 della raccolta di elementi Compile.

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

Vedere anche

Concetti

Attività di MSBuild

Altre risorse

Riferimenti delle attività MSBuild