Attività CL
Esegue il wrapping dello strumento del compilatore di Visual C++, cl.exe.Il compilatore produce file eseguibili con estensione exe, file di librerie a collegamento dinamico con estensione dll o un modulo di codice con estensionenetmodule.Per ulteriori informazioni, vedere Opzioni del compilatore.
Parametri
Nella tabella riportata di seguito sono descritti i parametri dell'attività CL.La maggior parte dei parametri dell'attività e alcuni set di parametri, corrispondere a un'opzione della riga di comando.
Parametro |
Descrizione |
|---|---|
AdditionalIncludeDirectories |
Parametro String[] facoltativo. Aggiunge una directory all'elenco di directory in cui viene eseguita la ricerca dei file di inclusione. Per ulteriori informazioni, vedere /I (Directory di inclusione aggiuntive). |
AdditionalOptions |
Parametro String facoltativo. Elenco di opzioni della riga di comando.Ad esempio, "/option1 /option2 /option#".Utilizzare questo parametro per specificare opzioni della riga di comando che non sono rappresentate da nessun altro parametro dell'attività. Per ulteriori informazioni, vedere Opzioni del compilatore. |
AdditionalUsingDirectories |
Parametro String[] facoltativo. Specifica una directory in cui il compilatore eseguirà la ricerca per risolvere i riferimenti passati alla direttiva #using. Per ulteriori informazioni, vedere /AI (Specifica le directory di metadati). |
AlwaysAppend |
Parametro String facoltativo. Una stringa che viene sempre generata sulla riga di comando.Il valore predefinito è "/c". |
AssemblerListingLocation |
Crea un file di listato che contenga il codice assembly. Per ulteriori informazioni, vedere l'opzione /Fa in /FA, /Fa (File di listato). |
AssemblerOutput |
Parametro String facoltativo. Crea un file di listato che contenga il codice assembly. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
NoListing<nessuno>
AssemblyCode/FA
AssemblyAndMachineCode/FAc
AssemblyAndSourceCode/FAs
All/FAcs
Per ulteriori informazioni, vedere /FA, /FAc, /FAs e le opzioni /FAcs in /FA, /Fa (File di listato). |
BasicRuntimeChecks |
Parametro String facoltativo. Abilita e disabilita la funzionalità relativa ai controlli di runtime, utilizzando il pragma runtime_checks. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
Default<nessuno>
StackFrameRuntimeCheck/RTCs
UninitializedLocalUsageCheck/RTCu
EnableFastChecks/RTC1
Per ulteriori informazioni, vedere /RTC (Controlli di runtime). |
BrowseInformation |
Parametro Boolean facoltativo. Se true, crea un file di informazioni di visualizzazione. Per ulteriori informazioni, vedere l'opzione /FR in /FR, /Fr (Crea file sbr). |
BrowseInformationFile |
Parametro String facoltativo. Consente di specificare il nome del file di informazioni di visualizzazione. Per ulteriori informazioni, vedere il parametro BrowseInformation in questa tabella e vedere anche /FR, /Fr (Crea file sbr). |
BufferSecurityCheck |
Parametro Boolean facoltativo. Se true, rileva i sovraccarichi del buffer che sovrascrivono l'indirizzo di ritorno, una tecnica comune utilizzata per sfruttare il codice che non attiva le restrizioni della dimensione del buffer. Per ulteriori informazioni, vedere /GS (Controllo sicurezza buffer). |
BuildingInIDE |
Parametro Boolean facoltativo. Se true, indica che MSBuild viene richiamato dall'IDE.In caso contrario, MSBuild viene richiamato sulla riga di comando. |
CallingConvention |
Parametro String facoltativo. Specifica la convenzione della chiamata, che determina l'ordine di inserimento delle funzioni nello stack, stabiliscono se la funzione chiamante o la funzione chiamata rimuove gli argomenti dallo stack alla fine della chiamata e indicano la convenzione di decorazione dei nomi utilizzata dal compilatore per identificare le singole funzioni. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
Cdecl/Gd
FastCall/Gr
StdCall/Gz
Per ulteriori informazioni, vedere /Gd, /Gr, /Gz (Convenzione di chiamata). |
CompileAs |
Parametro String facoltativo. Specifica se compilare il file di input come file di origine C++ o C. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
Default<nessuno>
CompileAsC/TC
CompileAsCpp/TP
Per ulteriori informazioni, vedere /Tc, /Tp, /TC, /TP (Specifica il tipo di file di origine). |
CompileAsManaged |
Parametro String facoltativo. Consente ad applicazioni e componenti di utilizzare le funzionalità di Common Language Runtime (CLR). Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
false<nessuno>
true/clr
Pure/clr:pure
Safe/clr:safe
OldSyntax/clr:oldSyntax
Per ulteriori informazioni, vedere /clr (Compilazione Common Language Runtime). |
CreateHotpatchableImage |
Parametro Boolean facoltativo. Se true, indica al compilatore di preparare un'immagine per l' applicazione di hot patch.Questo parametro garantisce che la prima istruzione di ciascuna funzione sia a due byte, ovvero la dimensione richiesta per l'applicazione di una hot patch. Per ulteriori informazioni, vedere /hotpatch (Crea immagine con funzionalità di patch a caldo). |
DebugInformationFormat |
Parametro String facoltativo. Consente di selezionare il tipo di informazioni di debug create per il programma e indicano se conservare tali informazioni nei file oggetto (obj) o in un database di programma (pdb). Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
OldStyle/Z7
ProgramDatabase/Zi
EditAndContinue/ZI
Per ulteriori informazioni, vedere /Z7, /Zi, /ZI (Formato informazioni di debug). |
DisableLanguageExtensions |
Parametro Boolean facoltativo. Se true, indica al compilatore di generare un errore per costrutti di linguaggio che non sono compatibili con ANSI C o ANSI C++. Per ulteriori informazioni, vedere l'opzione /Za in /Za, /Ze (Disabilita estensioni linguaggio). |
DisableSpecificWarnings |
Parametro String[] facoltativo. Disabilita i numeri di avviso specificati in un elenco delimitato da punti e virgola. Per ulteriori informazioni, vedere l'opzione /wd in /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Livello avvisi). |
EnableEnhancedInstructionSet |
Parametro String facoltativo. Specifica l'architettura per la generazione di codice che utilizza le istruzioni Streaming SIMD Extensions (SSE) e Streaming SIMD Extensions 2 (SSE2). Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
StreamingSIMDExtensions/arch:SSE
StreamingSIMDExtensions2/arch:SSE2
Per ulteriori informazioni, vedere /arch (x86). |
EnableFiberSafeOptimizations |
Parametro Boolean facoltativo. Se true, supporta l'indipendenza da fiber per i dati assegnati utilizzando l'archiviazione locale di thread statica, ovvero i dati allocati utilizzando __declspec(thread). Per ulteriori informazioni, vedere /GT (Supporta archiviazione locale di thread indipendente da fiber). |
EnablePREfast |
Parametro Boolean facoltativo. Se true, abilita l'analisi del codice. Per ulteriori informazioni, vedere /analyze (Analisi codice). |
ErrorReporting |
Parametro String facoltativo. Consentire di fornire informazioni su errori interni del compilatore (ICE) direttamente a Microsoft.Per impostazione predefinita, l'impostazione nelle compilazioni IDE è Prompt e l'impostazione nelle compilazioni da riga di comando è Queue. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
None/errorReport:none
Prompt/errorReport:prompt
Queue/errorReport:queue
Send/errorReport:send
Per ulteriori informazioni, vedere /errorReport (Segnala gli errori interni del compilatore). |
ExceptionHandling |
Parametro String facoltativo. Specifica il modello di gestione delle eccezioni che il compilatore deve utilizzare. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
false<nessuno>
Async/EHa
Sync/EHsc
SyncCThrow/EHs
Per ulteriori informazioni, vedere /EH (Modello di gestione delle eccezioni). |
ExpandAttributedSource |
Parametro Boolean facoltativo. Se true, crea un file dell'elenco che ha espanso gli attributi inseriti nel file di origine. Per ulteriori informazioni, vedere /Fx (Esegue il merge del codice). |
FavorSizeOrSpeed |
Parametro String facoltativo. Specifica se favorire la dimensione del codice o la velocità del codice. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
Neither<nessuno>
Size/Os
Speed/Ot
Per ulteriori informazioni, vedere /Os, /Ot (Ottimizza per dimensione codice, Ottimizza per velocità codice). |
FloatingPointExceptions |
Parametro Boolean facoltativo. Se true, abilita il modello di eccezioni a virgola mobile affidabile.Le eccezioni si verificheranno non appena generate. Per ulteriori informazioni, vedere l'opzione /fp:except in /fp (Specifica il comportamento della virgola mobile). |
FloatingPointModel |
Parametro String facoltativo. Imposta il modello della virgola mobile. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
Precise/fp:precise
Strict/fp:strict
Fast/fp:fast
Per ulteriori informazioni, vedere /fp (Specifica il comportamento della virgola mobile). |
ForceConformanceInForLoopScope |
Parametro Boolean facoltativo. Se true, implementa il comportamento C++ standard in per i cicli che utilizzano le estensioni Microsoft (/Ze). Per ulteriori informazioni, vedere /Zc:forScope (Imponi conformità nell'ambito di un ciclo For). |
ForcedIncludeFiles |
Parametro String[] facoltativo. Fa sì che il preprocessore elabori uno o più file di intestazione specificati. Per ulteriori informazioni, vedere /FI (Specifica il file di inclusione da utilizzare). |
ForcedUsingFiles |
Parametro String[] facoltativo. Fa sì che il preprocessore elabori uno o più file #using specificati. Per ulteriori informazioni, vedere /FU (Specifica file #using da utilizzare). |
FunctionLevelLinking |
Parametro Boolean facoltativo. Se true, consente al compilatore di creare il package di singole funzioni sotto forma di funzioni di package (COMDAT). Per ulteriori informazioni, vedere /Gy (Attiva collegamento a livello di funzione). |
GenerateXMLDocumentationFiles |
Parametro Boolean facoltativo. Se true, il compilatore elabora i commenti relativi alla documentazione nei file di codice sorgente e di creare un file xdc per ciascun file di codice sorgente che contiene commenti relativi alla documentazione. Per ulteriori informazioni, vedere /doc (Elabora i commenti per la documentazione) (C/C++).Vedere anche il parametro XMLDocumentationFileName in questa tabella. |
IgnoreStandardIncludePath |
Parametro Boolean facoltativo. Se true, impedisce al compilatore di effettuare ricerche di file di inclusione in directory specificate nelle variabili di ambiente PATH e INCLUDE. Per ulteriori informazioni, vedere /X (Ignora percorso di inclusione standard). |
InlineFunctionExpansion |
Parametro String facoltativo. Specifica il livello di espansione della funzione inline per la compilazione. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
Default<nessuno>
Disabled/Ob0
OnlyExplicitInline/Ob1
AnySuitable/Ob2
Per ulteriori informazioni, vedere /Ob (Espansione funzioni inline). |
IntrinsicFunctions |
Parametro Boolean facoltativo. Se true, sostituisce alcune chiamate di funzione con formati intrinseci o speciali della funzione che consentono di velocizzare l'esecuzione dell'applicazione. Per ulteriori informazioni, vedere /Oi (Genera funzioni intrinseche). |
MinimalRebuild |
Parametro Boolean facoltativo. Se true, abilita la ricompilazione minima, che determina se è necessario ricompilare i file di origine C++ che includono le definizioni di classe C++ modificate, archiviate nei file di intestazione con estensione h. Per ulteriori informazioni, vedere /Gm (Attiva ricompilazione minima). |
MultiProcessorCompilation |
Parametro Boolean facoltativo. Se true, utilizzare più processori da compilare.Questo parametro crea un processo per ogni processore valido nel computer. Per ulteriori informazioni, vedere /MP (compilazione con più processi).Vedere anche il parametro ProcessorNumber in questa tabella. |
ObjectFileName |
Parametro String facoltativo. Specifica un nome di file oggetto (obj) o una directory da utilizzare al posto di quella predefinita. Per ulteriori informazioni, vedere /Fo (Nome file oggetto). |
ObjectFiles |
Parametro String[] facoltativo. Un elenco di file oggetto. |
OmitDefaultLibName |
Parametro Boolean facoltativo. Se true, omette il nome della libreria di runtime C predefinita dal file oggetto (obj).Per impostazione predefinita, il compilatore inserisce il nome della libreria nel file obj per indirizzare il linker alla libreria corretta. Per ulteriori informazioni, vedere /Zl (Omette il nome della libreria predefinita). |
OmitFramePointers |
Parametro Boolean facoltativo. Se true, disattiva la creazione di puntatori ai frame sullo stack di chiamate. Per ulteriori informazioni, vedere /Oy (Omissione dei puntatori ai frame). |
OpenMPSupport |
Parametro Boolean facoltativo. Se true, fa in modo che il compilatore elabori clausole OpenMP e direttive. Per ulteriori informazioni, vedere /openmp (Attiva supporto OpenMP 2.0). |
Optimization |
Parametro String facoltativo. Specifica le varie ottimizzazioni del codice per la velocità e la dimensione. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
Disabled/Od
MinSpace/O1
MaxSpeed/O2
Full/Ox
Per ulteriori informazioni, vedere Opzioni /O (Ottimizza codice). |
PrecompiledHeader |
Parametro String facoltativo. Creare o utilizzare un file (pch) di intestazione precompilato durante la compilazione. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
NotUsing<nessuno>
Create/Yc
Use/Yu
Per ulteriori informazioni, vedere /Yc (Crea il file di intestazione precompilato) e /Yu (Utilizza il file di intestazione precompilato).Vedere anche i parametri PrecompiledHeaderFile e PrecompiledHeaderOutputFile in questa tabella. |
PrecompiledHeaderFile |
Parametro String facoltativo. Specifica un nome del file di intestazione precompilato da creare o utilizzare. Per ulteriori informazioni, vedere /Yc (Crea il file di intestazione precompilato) e /Yu (Utilizza il file di intestazione precompilato). |
PrecompiledHeaderOutputFile |
Parametro String facoltativo. Specifica un nome di percorso per un'intestazione precompilata da utilizzare al posto di quello predefinito. Per ulteriori informazioni, vedere /Fp (Specifica file pch). |
PreprocessKeepComments |
Parametro Boolean facoltativo. Se true, conserva i commenti durante la pre-elaborazione. Per ulteriori informazioni, vedere /C (Conserva i commenti durante la pre-elaborazione). |
PreprocessorDefinitions |
Parametro String[] facoltativo. Definisce un simbolo di pre-elaborazione per il file di origine. Per ulteriori informazioni, vedere /D (definizioni preprocessore). |
PreprocessOutput |
Parametro ITaskItem[] facoltativo. Definisce una matrice di elementi di output del preprocessore che può essere utilizzato ed emesso dalle attività. |
PreprocessOutputPath |
Parametro String facoltativo. Specifica il nome del file di output sul quale il parametro PreprocessToFile scrive output pre-elaborato. Per ulteriori informazioni, vedere /Fi (pre-elaborazione nome file di output). |
PreprocessSuppressLineNumbers |
Parametro Boolean facoltativo. Se true, pre-elabora i file di origine C e C++ e copia i file pre-elaborati nel dispositivo di output standard. Per ulteriori informazioni, vedere /EP (Pre-elabora in stdout senza direttive #line). |
PreprocessToFile |
Parametro Boolean facoltativo. Se true, pre-elabora i file di origine C e C++ e scrive l'output pre-elaborato in un file. Per ulteriori informazioni, vedere /P (Pre-elabora in un file). |
ProcessorNumber |
Parametro Integer facoltativo. Specifica il numero massimo di processori da utilizzare in una compilazione multiprocessore.Utilizzare questo parametro in combinazione con il parametro MultiProcessorCompilation- |
ProgramDataBaseFileName |
Parametro String facoltativo. Specifica un nome per il file del database di programma (PDB). Per ulteriori informazioni, vedere /Fd (Nome file database di programma). |
RuntimeLibrary |
Parametro String facoltativo. Indica se un modulo con multithreading è una DLL e seleziona versioni finali o di debug della libreria di runtime. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
MultiThreaded/MT
MultiThreadedDebug/MTd
MultiThreadedDLL/MD
MultiThreadedDebugDLL/MDd
Per ulteriori informazioni, vedere /MD, /MT, /LD (Utilizza la libreria di runtime). |
RuntimeTypeInfo |
Parametro Boolean facoltativo. Se true, aggiunge il codice per controllare in fase di esecuzione (informazioni sul tipo di runtime) i tipi di oggetti C++. Per ulteriori informazioni, vedere /GR (Attiva informazioni sui tipi in fase di esecuzione). |
ShowIncludes |
Parametro Boolean facoltativo. Se true, determina l'output di un elenco di file di inclusione da parte del compilatore. Per ulteriori informazioni, vedere /showIncludes (Elenca i file di inclusione). |
SmallerTypeCheck |
Parametro Boolean facoltativo. Se true, segnala un errore di runtime se un valore viene assegnato a un tipo di dati più piccolo e provoca una perdita di dati. Per ulteriori informazioni, vedere l'opzione /RTCc in /RTC (Controlli di runtime). |
Sources |
Parametro ITaskItem[] obbligatorio. Specifica un elenco di file di origine separati dagli spazi. |
StringPooling |
Parametro Boolean facoltativo. Se true, abilita il compilatore a creare una copia di stringhe identiche nell'immagine del programma. Per ulteriori informazioni, vedere /GF (Elimina stringhe duplicate). |
StructMemberAlignment |
Parametro String facoltativo. Specifica l'allineamento dei byte per tutti i membri in una struttura. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
Default/Zp1
1Byte/Zp1
2Bytes/Zp2
4Bytes/Zp4
8Bytes/Zp8
16Bytes/Zp16
Per ulteriori informazioni, vedere /Zp (Allineamento membri struct). |
SuppressStartupBanner |
Parametro Boolean facoltativo. Se true, impedisce la visualizzazione del copyright e il messaggio del numero di versione quando l'attività inizia. Per ulteriori informazioni, vedere /nologo (Non visualizza il messaggio di avvio) (C/C++). |
TrackerLogDirectory |
Parametro String facoltativo. Specifica la directory intermedia dove vengono archiviati log di rilevamento per questa attività. Per ulteriori informazioni, vedere i parametri TLogReadFiles e TLogWriteFiles in questa tabella. |
TreatSpecificWarningsAsErrors |
Parametro String[] facoltativo. Tratta l'elenco specificato degli avvisi del compilatore come errori. Per ulteriori informazioni, vedere l'opzione /wen in /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Livello avvisi). |
TreatWarningAsError |
Parametro Boolean facoltativo. Se true, considera tutti gli avvisi del compilatore come errori. Per ulteriori informazioni, vedere l'opzione /WX in /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Livello avvisi). |
TreatWChar_tAsBuiltInType |
Parametro Boolean facoltativo. Se true, tratta il tipo wchar_t come un tipo nativo. Per ulteriori informazioni, vedere /Zc:wchar_t (Tipo nativo wchar_t). |
UndefineAllPreprocessorDefinitions |
Parametro Boolean facoltativo. Se true rimuove la definizione dei simboli specifici Microsoft definiti dal compilatore. Per ulteriori informazioni, vedere l'opzione /u in /U, /u (Annulla la definizione dei simboli). |
UndefinePreprocessorDefinitions |
Parametro String[] facoltativo. Specifica un elenco di uno o più simboli del preprocessatore da non definire. Per ulteriori informazioni, vedere l'opzione /U in /U, /u (Annulla la definizione dei simboli). |
UseFullPaths |
Parametro Boolean facoltativo. Se true, visualizza il percorso completo dei file di codice sorgente passati al compilatore nella diagnostica. Per ulteriori informazioni, vedere /FC (Percorso completo del file di codice sorgente nella diagnostica). |
UseUnicodeForAssemblerListing |
Parametro Boolean facoltativo. Se true, fa in modo che il file di output venga creato in formato UTF-8. Per ulteriori informazioni, vedere l'opzione /FAu in /FA, /Fa (File di listato). |
WarningLevel |
Parametro String facoltativo. Specifica il livello più alto degli avvisi che deve essere generato dal compilatore. Specificare uno dei valori seguenti, ognuno dei quali corrisponde a un'opzione della riga di comando.
ValoreOpzione della riga di comando
TurnOffAllWarnings/W0
Level1/W1
Level2/W2
Level3/W3
Level4/W4
EnableAllWarnings/Wall
Per ulteriori informazioni, vedere l'opzione /Wn in /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Livello avvisi). |
WholeProgramOptimization |
Parametro Boolean facoltativo. Se true, abilita l'ottimizzazione dell'intero programma. Per ulteriori informazioni, vedere /GL (Ottimizzazione intero programma). |
XMLDocumentationFileName |
Parametro String facoltativo. Specifica il nome dei file di documentazione XML generati.Questo parametro può essere un file o un nome di directory. Per ulteriori informazioni, vedere l'argomento name in /doc (Elabora i commenti per la documentazione) (C/C++).Vedere anche il parametro GenerateXMLDocumentationFiles in questa tabella. |
MinimalRebuildFromTracking |
Parametro Boolean facoltativo. Se true, viene eseguita una compilazione incrementale tracciata; se false, viene eseguita una ricompilazione. |
TLogReadFiles |
Parametro ITaskItem[] facoltativo. Specifica una matrice di elementi che rappresentano i log di rilevamento di lettura file. In un log di rilevamento (con estensione tlog) di lettura file sono presenti i nomi dei file di input che vengono letti da un'attività. Il log viene utilizzato dal sistema di compilazione del progetto per supportare le compilazioni incrementali.Per ulteriori informazioni, vedere i parametri TrackerLogDirectory e TrackFileAccess in questa tabella. |
TLogWriteFiles |
Parametro ITaskItem[] facoltativo. Specifica una matrice di elementi che rappresentano i log di rilevamento di scrittura file. In un log di rilevamento (con estensione tlog) di scrittura file sono presenti i nomi dei file di output che vengono scritti da un'attività. Il log viene utilizzato dal sistema di compilazione del progetto per supportare le compilazioni incrementali.Per ulteriori informazioni, vedere i parametri TrackerLogDirectory e TrackFileAccess in questa tabella. |
TrackFileAccess |
Parametro Boolean facoltativo. Se true, rileva modelli di accesso ai file. Per ulteriori informazioni, vedere i parametri TLogReadFiles e TLogWriteFiles in questa tabella. |