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 estensione netmodule. 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.
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.
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.
Per ulteriori informazioni, vedere /Gd, /Gr, /Gv, /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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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. |