Csc (attività)

Esegue il wrapping di csc.exe e produce file eseguibili (EXE), librerie a collegamento dinamico (file DLL) o moduli di codice (file NETMODULE). Per altre informazioni su csc.exe, vedere Opzioni del compilatore C#.

Parametri

Nella tabella che segue vengono descritti i parametri dell'attività Csc.

Parametro	Descrizione
AdditionalLibPaths	Parametro String[] facoltativo. Specifica directory aggiuntive in cui cercare i riferimenti. Per altre informazioni, vedere -lib (opzioni del compilatore C#).
AddModules	Parametro String facoltativo. Specifica uno o più moduli che devono fare parte dell'assembly. Per altre informazioni, vedere -addmodule (opzioni del compilatore C#).
AllowUnsafeBlocks	Parametro Boolean facoltativo. Se true, compila codice che usa la parola chiave unsafe. Per altre 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 in cui caricare una DLL. L'indirizzo di base predefinito per una DLL viene impostato dal Common Language Runtime di .NET Framework. Per altre informazioni, vedere -baseaddress (opzioni del compilatore C#).
CheckForOverflowUnderflow	Parametro Boolean facoltativo. Specifica se il calcolo di interi che supera i limiti del tipo di dati genera un'eccezione in fase di esecuzione. Per altre informazioni, vedere -checked (opzioni del compilatore C#).
ChecksumAlgorithm	Parametro String facoltativo. Specifica l'algoritmo per il calcolo del checksum del file di origine archiviato nel file PDB. L'algoritmo deve essere SHA1 (impostazione predefinita) o SHA256. Vedere ChecksumAlgorithm.
CodeAnalysisRuleset	Parametro String facoltativo. Specifica un file di set di regole che disabilita la diagnostica specifica. Vedere CodeAnalysisRuleset.
CodePage	Parametro Int32 facoltativo. Specifica la tabella codici da usare per tutti i file del codice sorgente nella compilazione. Per altre 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 il programma viene avviato nel debugger, ma assembler viene visualizzato solo quando il programma in esecuzione è collegato al debugger. Questo parametro esegue l'override del parametro EmitDebugInformation. Per altre informazioni, vedere -debug (opzioni del compilatore C#).
DefineConstants	Parametro String facoltativo. Definisce i simboli del preprocessore. Per altre informazioni, vedere -define (opzioni del compilatore C#).
DelaySign	Parametro Boolean facoltativo. Se true, specifica che si vuole solo posizionare la chiave pubblica nell'assembly. Se false, specifica che si desidera un assembly completamente firmato Questo parametro ha effetto solo se usato con il parametro KeyFile o KeyContainer. Per altre informazioni, vedere -delaysign (opzioni del compilatore C#).
Deterministic	Parametro Boolean facoltativo. Se true, l'output del compilatore è un assembly il cui contenuto binario è identico in tutte le compilazioni se gli input sono identici. Per altre informazioni, vedere -deterministic (opzioni del compilatore C#).
DisabledWarnings	Parametro String facoltativo. Specifica l'elenco di avvisi da disabilitare. Per altre informazioni, vedere -nowarn (opzioni del compilatore C#).
DocumentationFile	Parametro String facoltativo. Elabora commenti sulla documentazione in un file XML. Per altre informazioni, vedere -doc (opzioni del compilatore C#).
EmbedAllSources	Parametro Boolean facoltativo. Incorporare tutti i file di origine nel file PDB. Per altre informazioni, vedere -embed (opzioni del compilatore C#)
EmitDebugInformation	Parametro Boolean facoltativo. If true, l'attività genera informazioni di debug e le inserisce in un file di database di programma (con estensione PDB). Se false, l'attività non genera alcuna informazione di debug. Il valore predefinito è false. Per altre informazioni, vedere -debug (opzioni del compilatore C#).
ErrorLog	Parametro String facoltativo. Specifica un file per registrare tutta la diagnostica del compilatore e dell'analizzatore. Vedere ErrorLog.
ErrorReport	Parametro String facoltativo. Offre un modo pratico per segnalare a Microsoft un errore interno di C#. Il valore di questo parametro può essere prompt, send o none. Se il parametro è impostato su prompt, si riceve un avviso quando si verifica un errore interno del compilatore. L'avviso consente di inviare elettronicamente una segnalazione a Microsoft. Se il parametro è impostato su send, viene inviato automaticamente un report sui bug. Se il parametro è impostato su none, l'errore viene segnalato solo nell'output di testo del compilatore. Il valore predefinito è none. Per altre informazioni, vedere -errorreport (opzioni del compilatore C#).
FileAlignment	Parametro Int32 facoltativo. Specifica le dimensioni delle sezioni nel file di output. Per altre informazioni, vedere -filealign (opzioni del compilatore C#).
GenerateFullPaths	Parametro Boolean facoltativo. Se true, specifica il percorso assoluto al file nell'output del compilatore. Se false, specifica il nome del file. Il valore predefinito è false. Per altre informazioni, vedere -fullpaths (opzioni del compilatore C#).
HighEntropyVA	Parametro Boolean facoltativo Abilitare la randomizzazione asLR (Address Space Layout Randomization) ad alta entropia. Vedere HighEntropyVA.
KeyContainer	Parametro String facoltativo. Specifica il nome del contenitore di chiavi crittografiche. Per altre informazioni, vedere -keycontainer (opzioni del compilatore C#).
KeyFile	Parametro String facoltativo. Specifica il nome del file contenente la chiave di crittografia. Per altre informazioni, vedere -keyfile (opzioni del compilatore C#).
LangVersion	Parametro String facoltativo. Specifica la versione del linguaggio da usare. Per altre informazioni, vedere -langversion (opzioni del compilatore C#).
LinkResources	Parametro ITaskItem[] facoltativo. Crea un collegamento a una risorsa .NET Framework nel file di output. Il file di risorse non viene inserito nel file di output. Gli elementi passati a questo parametro possono avere voci di metadati facoltativi denominati LogicalName e Access. LogicalName corrisponde al parametro identifier dell'opzione /linkresource e Access corrisponde al parametro accessibility-modifier. Per altre informazioni, vedere -linkresource (opzioni del compilatore C#).
MainEntryPoint	Parametro String facoltativo. Specifica il percorso del metodo Main. Per altre informazioni, vedere -main (opzioni del compilatore C#).
ModuleAssemblyName	Parametro String facoltativo. Specifica il nome dell'assembly di cui fa parte il modulo.
NoConfig	Parametro Boolean facoltativo. Se true, indica al compilatore di non eseguire la compilazione con il file csc.rsp. Per altre informazioni, vedere -noconfig (opzioni del compilatore C#).
NoLogo	Parametro Boolean facoltativo. Se true, elimina la visualizzazione dei messaggi informativi del compilatore. Per altre informazioni, vedere -nologo (opzioni del compilatore C#).
NoStandardLib	Parametro Boolean facoltativo. Se true, impedisce l'importazione di mscorlib.dll, che definisce l'intero spazio dei nomi di sistema. Usare questo parametro se si vuole definire o creare uno spazio dei nomi e oggetti di sistema personalizzati. Per altre informazioni, vedere -nostdlib (opzioni del compilatore C#).
NoWin32Manifest	Parametro Boolean facoltativo. Se true, non includere il manifesto Win32 predefinito.
Nullable	Parametro String facoltativo. Specifica il contesto nullable. L'argomento deve essere uno di enable, warningsdisable, o annotations. Vedere Nullable.
Optimize	Parametro Boolean facoltativo. Se true, abilita le ottimizzazioni. Se false, disabilita le ottimizzazioni. Per altre informazioni, vedere -optimize (opzioni del compilatore C#).
OutputAssembly	Parametro di output String facoltativo. Specifica il nome del file di output. Per altre informazioni, vedere -out (opzioni del compilatore C#).
OutputRefAssembly	Parametro String facoltativo. Specifica il nome del file di assembly di riferimento di output. Per altre informazioni, vedere -refout (opzioni del compilatore C#).
PathMap	Parametro String facoltativo. Specifica come eseguire il mapping di percorsi fisici ai nomi di percorso di origine restituiti dal compilatore. Vedere PathMap.
PdbFile	Parametro String facoltativo. Specifica il nome file delle informazioni di debug. Il nome predefinito è il nome file di output con estensione pdb.
Platform	Parametro String facoltativo. Specifica la piattaforma del processore da impostare come destinazione del file di output. Il valore di questo parametro può essere x86, x64 o anycpu. Il valore predefinito è anycpu. Per altre informazioni, vedere -platform (opzioni del compilatore C#).
PreferredUILang	Parametro String facoltativo. Specifica il linguaggio in cui il compilatore C# visualizza l'output, ad esempio i messaggi di errore. Vedere PreferredUILang.
PublicSign	Parametro Boolean facoltativo. Firmare pubblicamente l'assembly di output. Vedere PublicSign.
References	Parametro ITaskItem[] facoltativo. Specifica l'attività per importare informazioni di tipi pubblico dagli elementi specificati nel progetto corrente. Per altre informazioni, vedere -reference (opzioni del compilatore C#). È possibile specificare un alias di riferimento C# in un file MSBuild aggiungendo i metadati Aliases all'elemento "Reference" originale. Ad esempio, per impostare l'alias "LS1" nella riga di comando Csc seguente: CSC /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs è necessario usare: <Reference Include="MyCodeLibrary"> <Aliases>LS1</Aliases> </Reference>
RefOnly	Parametro Boolean facoltativo. Produrre un assembly di riferimento, anziché un assembly completo, come output primario. Vedere ProduceOnlyReferenceAssembly.
ReportAnalyzer	Parametro Boolean facoltativo. Restituire informazioni aggiuntive dell'analizzatore, ad esempio il tempo di esecuzione. Vedere ReportAnalyzer.
Resources	Parametro ITaskItem[] facoltativo. Incorpora una risorsa di .NET Framework nel file di output. Gli elementi passati a questo parametro possono avere voci di metadati facoltativi denominati LogicalName e Access. LogicalName corrisponde al parametro identifier dell'opzione /resource e Access corrisponde al parametro accessibility-modifier. Per altre informazioni, vedere -resource (opzioni del compilatore C#).
ResponseFiles	Parametro String facoltativo. Specifica il file di risposta che contiene i comandi per questa attività. Per altre informazioni, vedere @ (specificare il file di risposta).
Sources	Parametro ITaskItem[] facoltativo. Specifica uno o più file di origine C#.
TargetType	Parametro String facoltativo. Specifica il formato del file di output. Questo parametro può avere un valore di library, che crea una libreria di codice, exe, che crea un'applicazione console, module, che crea un modulo o winexe, che crea un programma Windows. Il valore predefinito è library. Per altre informazioni, vedere -target (opzioni del compilatore C#).
TreatWarningsAsErrors	Parametro Boolean facoltativo. Se true, tutti gli avvisi vengono considerati come errori. Per altre informazioni, vedere -warnaserror (opzioni del compilatore C#).
UseHostCompilerIfAvailable	Parametro Boolean facoltativo. Indica all'attività di usare l'oggetto del compilatore in corso, se disponibile. Usata solo da Visual Studio.
Utf8Output	Parametro Boolean facoltativo. Registra l'output del compilatore tramite la codifica UTF-8. Per altre informazioni, vedere -utf8output (opzioni del compilatore C#).
WarningLevel	Parametro Int32 facoltativo. Specifica il livello di avviso da visualizzare nel compilatore. Per altre informazioni, vedere -warn (opzioni del compilatore C#).
WarningsAsErrors	Parametro String facoltativo. Specifica un elenco di avvisi da considerare come errori. Per altre informazioni, vedere -warnaserror (opzioni del compilatore C#). Questo parametro esegue l'override del parametro TreatWarningsAsErrors.
WarningsNotAsErrors	Parametro String facoltativo. Specifica un elenco di avvisi che non vengono considerati errori. Per altre informazioni, vedere -warnaserror (opzioni del compilatore C#). Questo parametro è utile solo se il parametro TreatWarningsAsErrors è impostato su true.
Win32Icon	Parametro String facoltativo. Inserisce un file con estensione ico nell'assembly, che dà al file di output l'aspetto voluto in Esplora file. Per altre informazioni, vedere -win32icon (opzioni del compilatore C#).
Win32Manifest	Parametro String facoltativo. Specifica il manifesto Win32 da includere.
Win32Resource	Parametro String facoltativo. Inserisce nel file di output un file di risorsa Win32 (RES). Per altre informazioni, vedere -win32res (opzioni del compilatore C#).

Parametri ToolTaskExtension

Questa attività eredita dalla ToolTaskExtension classe , che eredita dalla ToolTask classe , che a sua volta eredita dalla Task classe . Questa catena di ereditarietà aggiunge diversi parametri alle attività che ne derivano.

Nella tabella seguente vengono descritti i parametri delle classi di base:

Parametro	Descrizione
EchoOff	Parametro bool facoltativo. Se impostata su true, questa attività passa /Q alla riga di comando di cmd.exe in modo che la riga di comando non venga copiata in stdout.
EnvironmentVariables	Parametro di matrice String facoltativo. Matrice di definizioni di variabili di ambiente, separate da punti e virgola. Ogni definizione deve specificare un nome di variabile di ambiente e un valore separati da un segno di uguale. Queste variabili vengono passate all'eseguibile generato in aggiunta a o con override selettivo del blocco di ambiente standard. Ad esempio, Variable1=Value1;Variable2=Value2.
ExitCode	Parametro di sola lettura di output Int32 facoltativo. Specifica il codice di uscita fornito dal comando eseguito. Se l'attività ha registrato errori, ma il processo ha un codice di uscita pari a 0 (esito positivo), il parametro viene impostato su -1.
LogStandardErrorAsError	Parametro bool facoltativo. Se true, tutti i messaggi ricevuti nel flusso di errori standard vengono registrati come errori.
StandardErrorImportance	Parametro String facoltativo. Importanza con cui registrare il testo dal flusso di errore standard.
StandardOutputImportance	Parametro String facoltativo. Importanza con cui registrare il testo dal flusso di output standard.
Timeout	Parametro Int32 facoltativo. Specifica la quantità di tempo, in millisecondi, dopo i quali l'eseguibile dell'attività viene terminato. Il valore predefinito è Int.MaxValue, con cui si indica che non esiste alcun periodo di timeout. Il timeout è espresso in millisecondi.
ToolExe	Parametro string facoltativo. I progetti possono implementarlo per eseguire l'override di un ToolName. Le attività possono eseguirne l'override per conservare il ToolName.
ToolPath	Parametro string facoltativo. Specifica la posizione da cui l'attività carica il file eseguibile sottostante. Se questo parametro non viene specificato, l'attività usa il percorso di installazione dell'SDK corrispondente alla versione del framework che esegue MSBuild.
UseCommandProcessor	Parametro bool facoltativo. Se true, questa attività crea un file batch per la riga di comando e lo esegue mediante il processore dei comandi anziché eseguire direttamente il comando.
YieldDuringToolExecution	Parametro bool facoltativo. Se true, questa attività restituisce il nodo quando l'attività è in esecuzione.

Esempio

Nell'esempio seguente viene usata l'attività Csc per compilare un eseguibile dai file di origine nella raccolta di elementi Compile.

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

Vedi anche

• Attività MSBuild
• Attività