Compartilhar via

Tarefa CL

  • Artigo

Ajusta a ferramenta do compilador Visual C++, cl.O compilador produz arquivos executáveis (. exe), arquivos de biblioteca de vínculo dinâmico (. dll) ou módulo de código (.arquivos netmodule).Para obter mais informações, consulte Opções do compilador.

Parâmetros

A tabela a seguir descreve os parâmetros da CL tarefa.A maioria dos parâmetros da tarefa e alguns conjuntos de parâmetros, correspondem a uma opção de linha de comando.

Parâmetro

Descrição

AdditionalIncludeDirectories

Parâmetro de [] String opcional.

Adiciona uma pasta à lista de diretórios que são pesquisadas por arquivos de inclusão.

Para obter mais informações, consulte /I (adicionais diretórios de inclusão).

AdditionalOptions

Parâmetro de seqüência de caracteres opcional.

Uma lista de opções de linha de comando.Por exemplo, "/Opção1 /2 /opção #".Use este parâmetro para especificar as opções de linha de comando que não são representadas por qualquer outro parâmetro da tarefa.

Para obter mais informações, consulte Opções do compilador.

AdditionalUsingDirectories

Parâmetro de [] String opcional.

Especifica um diretório que o compilador pesquisará para resolver referências de arquivo passaram para o #using diretiva.

Para obter mais informações, consulte /AI (especificam diretórios de metadados).

AlwaysAppend

Parâmetro de seqüência de caracteres opcional.

Uma seqüência de caracteres que sempre obtém emitida na linha de comando.Seu valor padrão é "/c".

AssemblerListingLocation

Cria um arquivo de listagem que contém o código de assembly.

Para obter mais informações, consulte o /Fa de opção em / FA, /Fa (arquivo de listagem).

AssemblerOutput

Parâmetro de seqüência de caracteres opcional.

Cria um arquivo de listagem que contém o código de assembly.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
NoListing<none>.
AssemblyCode/FA
AssemblyAndMachineCode/FAc
AssemblyAndSourceCode/FAs
All/FAcs

For more information, see the /FA, /FAc, /FAs, and /FAcs options in / FA, /Fa (arquivo de listagem).

BasicRuntimeChecks

Parâmetro de seqüência de caracteres opcional.

Habilita e desabilita o recurso de verificações de erro de tempo de execução, juntamente com o runtime_checks pragma.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
Default<none>.
StackFrameRuntimeCheck/RTCs
UninitializedLocalUsageCheck/RTCu
EnableFastChecks/RTC1

Para obter mais informações, consulte / RTC (verificações de erro em tempo de execução).

BrowseInformation

Parâmetro booleano opcional.

Se true, cria um arquivo de informações de procura.

Para obter mais informações, consulte o /FR de opção em / FR, /Fr (criar.Arquivo SBR).

BrowseInformationFile

Parâmetro de seqüência de caracteres opcional.

Especifica um nome de arquivo para o arquivo de informações de procura.

Para obter mais informações, consulte o BrowseInformation parâmetro nesta tabela e também consulte / FR, /Fr (criar.Arquivo SBR).

BufferSecurityCheck

Parâmetro booleano opcional.

Se true, detecta alguns estouros de buffer que substituem o endereço do remetente, uma técnica comum para explorar o código que não impõe restrições de tamanho de buffer.

Para obter mais informações, consulte /GS (verificação de segurança de buffer).

BuildingInIDE

Parâmetro booleano opcional.

Se true, indica que MSBuild é chamado pela IDE.Caso contrário, MSBuild é invocado na linha de comando.

CallingConvention

Parâmetro de seqüência de caracteres opcional.

Especifica a convenção de chamada, que determina a ordem na qual função argumentos são colocados na pilha, se a função do chamador ou a função chamada remove os argumentos da pilha no final da chamada e a convenção de decoração de nome que o compilador usa para identificar as funções individuais.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
Cdecl/Gd
FastCall/Gr
StdCall/Gz

Para obter mais informações, consulte / Gd, /Gr, /Gz (convenção de chamada).

CompileAs

Parâmetro de seqüência de caracteres opcional.

Especifica se deve compilar o arquivo de entrada como um arquivo de código-fonte c ou C++.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
Default<none>.
CompileAsC/TC
CompileAsCpp/TP

Para obter mais informações, consulte / Tc, /Tp, /TC, /TP (Especifica o tipo de arquivo de origem).

CompileAsManaged

Parâmetro de seqüência de caracteres opcional.

Permite que aplicativos e componentes usar os recursos do common language runtime (CLR).

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
false<none>.
true/clr
Pure/clr:pure
Safe/clr:safe
OldSyntax/clr:oldSyntax

Para obter mais informações, consulte /CLR (common Language Runtime Compilation).

CreateHotpatchableImage

Parâmetro booleano opcional.

Se true, informa o compilador para preparar uma imagem para hot patching.Este parâmetro garante que a primeira instrução da cada função de dois bytes, que é necessário para o hot patching.

Para obter mais informações, consulte /hotpatch (criar imagem de Hotpatchable).

DebugInformationFormat

Parâmetro de seqüência de caracteres opcional.

Seleciona o tipo de informações de depuração criadas para o seu programa e se essas informações são mantidas em arquivos de objeto (. obj) ou em um banco de dados do programa (PDB).

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
OldStyle/Z7
ProgramDatabase/Zi
EditAndContinue/ZI

Para obter mais informações, consulte / /Z7, /Zi, /ZI (formato informações de depuração).

DisableLanguageExtensions

Parâmetro booleano opcional.

Se true, informa o compilador para emitir um erro de construções de linguagem que não são compatíveis com ANSI C ou C++ ANSI.

Para obter mais informações, consulte o /Za de opção em / Za, /Ze (extensões de linguagem Disable).

DisableSpecificWarnings

Parâmetro de [] String opcional.

Desativa os números de aviso que são especificados em uma lista delimitada por ponto e vírgula.

Para obter mais informações, consulte o /wd de opção em /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso).

EnableEnhancedInstructionSet

Parâmetro de seqüência de caracteres opcional.

Especifica a arquitetura para a geração de código que usa o Streaming SIMD Extensions (SSE) e instruções Streaming SIMD Extensions 2 (SSE2).

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
StreamingSIMDExtensions/arch:SSE
StreamingSIMDExtensions2/arch:SSE2

Para obter mais informações, consulte /arch (x86).

EnableFiberSafeOptimizations

Parâmetro booleano opcional.

Se true, segurança de fibra de suporte para dados alocados por meio de armazenamento de segmento local estático, ou seja, os dados alocados por meio de __declspec(thread).

Para obter mais informações, consulte /Gt Observação: (armazenamento Local de segmento de suporte de fibra segura).

EnablePREfast

Parâmetro booleano opcional.

Se true, habilitar a análise de código.

Para obter mais informações, consulte /analyze (Análise do código).

ErrorReporting

Parâmetro de seqüência de caracteres opcional.

Permite que você forneça informações de erro (ICE) interno do compilador diretamente para a Microsoft.Por padrão, a configuração em compilações do IDE é Prompt e a configuração em compilações de linha de comando for Queue.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
None/errorReport:none
Prompt/errorReport:prompt
Queue/errorReport:queue
Send/errorReport:send

Para obter mais informações, consulte /ErrorReport (relatório de erros do compilador interno).

ExceptionHandling

Parâmetro de seqüência de caracteres opcional.

Especifica o modelo de tratamento de exceções a ser utilizado pelo compilador.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
false<none>.
Async/EHa
Sync/EHsc
SyncCThrow/EHs

Para obter mais informações, consulte /EH (modelo de manipulação de exceção).

ExpandAttributedSource

Parâmetro booleano opcional.

Se true, cria um arquivo de listagem que se expandiu atributos injetados no arquivo de origem.

Para obter mais informações, consulte /FX (mesclar o código injetado).

FavorSizeOrSpeed

Parâmetro de seqüência de caracteres opcional.

Especifica se deve favorecer a velocidade de tamanho ou o código do código.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
Neither<none>.
Size/Os
Speed/Ot

Para obter mais informações, consulte / /Ot (código de favor pequena, código de favor rápido) Os,.

FloatingPointExceptions

Parâmetro booleano opcional.

Se true, permite que o modelo de exceção de ponto flutuante confiável.Exceções serão geradas imediatamente depois que são acionados.

Para obter mais informações, consulte o /fp:except de opção em /FP (Especifica o comportamento de ponto flutuante).

FloatingPointModel

Parâmetro de seqüência de caracteres opcional.

Define a flutuação modelo de ponto.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
Precise/fp:precise
Strict/fp:strict
Fast/fp:fast

Para obter mais informações, consulte /FP (Especifica o comportamento de ponto flutuante).

ForceConformanceInForLoopScope

Parâmetro booleano opcional.

Se true, implementa o comportamento padrão do C++ no para loops que usam as extensões do Microsoft (/Ze).

Para obter mais informações, consulte /ZC:forScope (forçar conformidade no escopo de loop for).

ForcedIncludeFiles

Opcional String[] parâmetro.

Faz com que o pré-processador processar um ou mais arquivos de cabeçalho especificado.

Para obter mais informações, consulte /Fi (arquivo incluem o nome forçado).

ForcedUsingFiles

Opcional String[] parâmetro.

Faz com que o pré-processador para processar uma ou mais especificado #using arquivos.

Para obter mais informações, consulte /Fu (nome forçado # using do arquivo).

FunctionLevelLinking

Opcional Boolean parâmetro.

Se true, permite que o compilador funções individuais do pacote na forma de funções de pacotes (COMDATs).

Para obter mais informações, consulte /GY (nível de função para ativar vinculação).

GenerateXMLDocumentationFiles

Opcional Boolean parâmetro.

Se true, arquivos de código faz com que o compilador a processar documentação comentários no código-fonte e criar um arquivo de .xdc para cada arquivo de código-fonte com comentários da documentação.

Para obter mais informações, consulte /doc (processo documentação comentários) (C/C++).Consulte também o XMLDocumentationFileName parâmetro nesta tabela.

IgnoreStandardIncludePath

Opcional Boolean parâmetro.

Se true, impede que o compilador procurando arquivos de inclusão nas pastas especificadas na caixa variáveis de ambiente PATH e INCLUDE.

Para obter mais informações, consulte /X (Ignorar padrão incluir caminhos).

InlineFunctionExpansion

Opcional String parâmetro.

Especifica o nível de expansão da função in-line para a compilação.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
Default<none>.
Disabled/Ob0
OnlyExplicitInline/Ob1
AnySuitable/Ob2

Para obter mais informações, consulte /Ob (expansão de função embutida).

IntrinsicFunctions

Opcional Boolean parâmetro.

Se true, substitui alguma função chama com intrínseca ou caso contrário os formulários especiais da função que ajudam o seu aplicativo executado mais rapidamente.

Para obter mais informações, consulte /Oi (gerar funções intrínsecas).

MinimalRebuild

Opcional Boolean parâmetro.

Se true, permite a recompilação mínima, que determina se os arquivos de origem do C++ que incluem C++ alterados classe definições (armazenadas nos arquivos de cabeçalho (. h)) deve ser recompilada.

Para obter mais informações, consulte /GM (Habilitar recompilação mínima).

MultiProcessorCompilation

Opcional Boolean parâmetro.

Se true, use vários processadores para compilar.Este parâmetro cria um processo para cada processador eficaz no seu computador.

Para obter mais informações, consulte /MP (com vários processos de compilação).Além disso, consulte o ProcessorNumber parâmetro nesta tabela.

ObjectFileName

Opcional String parâmetro.

Especifica um nome de arquivo do objeto (. obj) ou o diretório a ser usado em vez do padrão.

Para obter mais informações, consulte /FO (nome do arquivo de objeto).

ObjectFiles

Opcional String[] parâmetro.

Uma lista de arquivos de objeto.

OmitDefaultLibName

Opcional Boolean parâmetro.

Se true, omite o nome da biblioteca de tempo de execução c padrão do arquivo de objeto (. obj).Por padrão, o compilador coloca o nome da biblioteca para o arquivo. obj para direcionar o vinculador a biblioteca correto.

Para obter mais informações, consulte /ZL (omitir o nome da biblioteca padrão).

OmitFramePointers

Opcional Boolean parâmetro.

Se true, suprime a criação dos ponteiros do quadro na pilha de chamadas.

Para obter mais informações, consulte /Oy (omissão do ponteiro do quadro).

OpenMPSupport

Opcional Boolean parâmetro.

Se true, faz com que o compilador a processar as cláusulas de OpenMP e diretivas.

Para obter mais informações, consulte /OpenMP (Habilitar OpenMP 2.0 suporte).

Optimization

Opcional String parâmetro.

Especifica várias otimizações de código para o tamanho e velocidade.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
Disabled/Od
MinSpace/O1
MaxSpeed/O2
Full/Ox

Para obter mais informações, consulte /O opções (otimizar o código).

PrecompiledHeader

Opcional String parâmetro.

Criar ou usar um arquivo de cabeçalho pré-compilado (.pch) durante a compilação.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
NotUsing<none>.
Create/Yc
Use/Yu

Para obter mais informações, consulte /Yc (criar arquivo de cabeçalho pré-compilado) e /Yu (arquivo de cabeçalho pré-compilado de uso).Além disso, consulte o PrecompiledHeaderFile e PrecompiledHeaderOutputFile parâmetros nesta tabela.

PrecompiledHeaderFile

Opcional String parâmetro.

Especifica um nome de arquivo de cabeçalho pré-compilado para criar ou usar.

Para obter mais informações, consulte /Yc (criar arquivo de cabeçalho pré-compilado) e /Yu (arquivo de cabeçalho pré-compilado de uso).

PrecompiledHeaderOutputFile

Opcional String parâmetro.

Especifica um nome de caminho para um cabeçalho pré-compilado em vez de usar o nome de caminho padrão.

Para obter mais informações, consulte /FP (nome.Arquivo de pch).

PreprocessKeepComments

Opcional Boolean parâmetro.

Se true, preserva comentários durante o pré-processamento.

Para obter mais informações, consulte /C (preservar comentários durante o pré-processamento).

PreprocessorDefinitions

Opcional String[] parâmetro.

Define um símbolo de pré-processamento para seu arquivo de origem.

Para obter mais informações, consulte /D (definições de pré-processador).

PreprocessOutput

Opcional ITaskItem[] parâmetro.

Define uma matriz de itens de saída de pré-processador que pode ser consumido e emitido por tarefas.

PreprocessOutputPath

Opcional String parâmetro.

Especifica o nome do arquivo de saída para que o PreprocessToFile parâmetro grava a saída pré-processado.

Para obter mais informações, consulte /Fi (pré-processar o nome do arquivo de saída).

PreprocessSuppressLineNumbers

Opcional Boolean parâmetro.

Se true, pré-processa os arquivos de código-fonte c e C++ e copia os arquivos pré-processado para o dispositivo de saída padrão.

Para obter mais informações, consulte /EP (pré-processo stdout sem # line diretivas).

PreprocessToFile

Opcional Boolean parâmetro.

Se true, pré-processa os arquivos de código-fonte c e C++ e grava a saída pré-processado para um arquivo.

Para obter mais informações, consulte /P (pré-processo para um arquivo).

ProcessorNumber

Opcional Integer parâmetro.

Especifica o número máximo de processadores para usar em uma compilação de multiprocessador.Use esse parâmetro em combinação com o MultiProcessorCompilation parâmetro.

ProgramDataBaseFileName

Opcional String parâmetro.

Especifica um nome de arquivo para o arquivo de banco de dados (PDB) do programa.

Para obter mais informações, consulte /FD (nome do arquivo de banco de dados de programa).

RuntimeLibrary

Opcional String parâmetro.

Indica se um módulo multithread é uma DLL e seleciona as versões de varejo ou depuração da biblioteca de tempo de execução.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
MultiThreaded/MT
MultiThreadedDebug/MTd
MultiThreadedDLL/MD
MultiThreadedDebugDLL/MDd

Para obter mais informações, consulte / MD, /MT, /LD (biblioteca de tempo de execução de uso).

RuntimeTypeInfo

Opcional Boolean parâmetro.

Se true, adiciona código para verificar os tipos de objetos C++ em tempo de execução (informações de tipo de tempo de execução).

Para obter mais informações, consulte /GR (informações de tipo de tempo de execução de enable).

ShowIncludes

Opcional Boolean parâmetro.

Se true, faz o compilador produzir uma lista dos arquivos de inclusão.

Para obter mais informações, consulte /showIncludes (lista incluir arquivos).

SmallerTypeCheck

Opcional Boolean parâmetro.

Se true, reporta um erro de tempo de execução, se um valor é atribuído a um tipo de dados menor e provoca uma perda de dados.

Para obter mais informações, consulte o /RTCc de opção em / RTC (verificações de erro em tempo de execução).

Sources

Obrigatório ITaskItem[] parâmetro.

Especifica uma lista dos arquivos de origem separados por espaços.

StringPooling

Opcional Boolean parâmetro.

Se true, permite que o compilador criar uma cópia de strings idênticas na imagem do programa.

Para obter mais informações, consulte /GF (eliminar a duplicata de cadeias de caracteres).

StructMemberAlignment

Opcional String parâmetro.

Especifica o alinhamento de byte para todos os membros em uma estrutura.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
Default/Zp1
1Byte/Zp1
2Bytes/Zp2
4Bytes/Zp4
8Bytes/Zp8
16Bytes/Zp16

Para obter mais informações, consulte /ZP (alinhamento de membro Struct).

SuppressStartupBanner

Opcional Boolean parâmetro.

Se true, impede a exibição da mensagem de número de versão e copyright quando a tarefa for iniciada.

Para obter mais informações, consulte /nologo (Suprimir faixa de inicialização) (C/C++).

TrackerLogDirectory

Opcional String parâmetro.

Especifica o diretório intermediário onde estão armazenados os logs de controle para esta tarefa.

Para obter mais informações, consulte o TLogReadFiles e TLogWriteFiles parâmetros nesta tabela.

TreatSpecificWarningsAsErrors

Opcional String[] parâmetro.

Trata a lista especificada de avisos como erros.

Para obter mais informações, consulte o /wen de opção em /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso).

TreatWarningAsError

Opcional Boolean parâmetro.

Se true, trate todos os avisos do compilador como erros.

Para obter mais informações, consulte /WX de opção em /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso).

TreatWChar_tAsBuiltInType

Opcional Boolean parâmetro.

Se true, trate o wchar_t tipo como um tipo nativo.

Para obter mais informações, consulte /ZC:wchar_t (wchar_t é o tipo nativo).

UndefineAllPreprocessorDefinitions

Opcional Boolean parâmetro.

Se true, os símbolos específicos da Microsoft que o compilador define de remoções de definição.

Para obter mais informações, consulte o /u de opção em / U, /u (cancele símbolos).

UndefinePreprocessorDefinitions

Opcional String[] parâmetro.

Especifica uma lista de um ou mais símbolos de pré-processamento para cancele.

Para obter mais informações, consulte /U de opção em / U, /u (cancele símbolos).

UseFullPaths

Opcional Boolean parâmetro.

Se true, exibe o caminho completo de arquivos de código fonte passado para o compilador no diagnóstico.

Para obter mais informações, consulte /FC (caminho completo do arquivo de código-fonte no diagnóstico).

UseUnicodeForAssemblerListing

Opcional Boolean parâmetro.

Se true, faz com que o arquivo de saída seja criado no formato UTF-8.

Para obter mais informações, consulte o /FAu de opção em / FA, /Fa (arquivo de listagem).

WarningLevel

Opcional String parâmetro.

Especifica o maior nível de aviso que deve ser gerado pelo compilador.

Especifica um dos seguintes valores, cada um correspondendo a uma opção de linha de comando.

ValorOpção de linha de comando
TurnOffAllWarnings/W0
Level1/W1
Level2/W2
Level3/W3
Level4/W4
EnableAllWarnings/Wall

Para obter mais informações, consulte o /Wn opção na /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso).

WholeProgramOptimization

Opcional Boolean parâmetro.

Se true, permite a otimização de programa inteiro.

Para obter mais informações, consulte /GL (otimização de programa total).

XMLDocumentationFileName

Opcional String parâmetro.

Especifica o nome dos arquivos de documentação XML gerados.Este parâmetro pode ser um nome de arquivo ou diretório.

Para obter mais informações, consulte o name argumento na /doc (processo documentação comentários) (C/C++).Consulte também o GenerateXMLDocumentationFiles parâmetro nesta tabela.

MinimalRebuildFromTracking

Opcional Boolean parâmetro.

Se true, é realizada uma compilação incremental controlada; Se false, uma reconstrução é executada.

TLogReadFiles

Opcional ITaskItem[] parâmetro.

Especifica uma matriz dos itens que representam a ler logs de controle de arquivo.

Um log de controle de arquivo de leitura (.tlog) contém os nomes dos arquivos de entrada que são lidos por uma tarefa e são usados pelo sistema de compilação do projeto para oferecer suporte a compilações incrementais.Para obter mais informações, consulte o TrackerLogDirectory e TrackFileAccess parâmetros nesta tabela.

TLogWriteFiles

Opcional ITaskItem[] parâmetro.

Especifica uma matriz dos itens que representam a gravar arquivo de logs de rastreamento.

Um log de controle de gravação de arquivo (.tlog) contém os nomes dos arquivos de saída que são escritos por uma tarefa e são usados pelo sistema de compilação do projeto para oferecer suporte a compilações incrementais.Para obter mais informações, consulte o TrackerLogDirectory e TrackFileAccess parâmetros nesta tabela.

TrackFileAccess

Opcional Boolean parâmetro.

Se true, rastreia padrões de acesso de arquivo.

Para obter mais informações, consulte o TLogReadFiles e TLogWriteFiles parâmetros nesta tabela.

Consulte também

Outros recursos

Referência de tarefa do MSBuild