Compartilhar via


Tarefa de CL

Encapsula 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 de tarefas. 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 incluem a diretórios).

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 esse 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 em 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. O 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 opção na / 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

Para obter mais informações, consulte o /FA, /FAc, /FAs, e /FAcs Opções / 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 de tempo de execução).

BrowseInformation

Em parâmetro booleano opcional.

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

Para obter mais informações, consulte o /FR opção na / 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 consulte também / FR, /Fr (criar.Arquivo SBR).

BufferSecurityCheck

Em parâmetro booleano opcional.

Se true, que detecta alguns estouros de buffer que substituir 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

Em 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

Em parâmetro booleano opcional.

Se true, que 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

Em parâmetro booleano opcional.

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

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

DisableSpecificWarnings

Parâmetro de [] String opcional.

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

Para obter mais informações, consulte o /wd opção na /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 de 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 (arquitetura de CPU mínimo).

EnableFiberSafeOptimizations

Em parâmetro booleano opcional.

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

Para obter mais informações, consulte /GT (armazenamento Local de segmento de suporte de fibra segura).

EnablePREfast

Em parâmetro booleano opcional.

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

Para obter mais informações, consulte /Analyze (análise de código da empresa).

ErrorReporting

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

Permite que você fornecer informações de erro (ICE) interno do compilador diretamente à 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

Em parâmetro booleano opcional.

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

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

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

Em parâmetro booleano opcional.

Se true, que 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 opção na /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

Em parâmetro booleano opcional.

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

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

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 (nome forçado incluem o arquivo).

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 a vinculação).

GenerateXMLDocumentationFiles

Opcional Boolean parâmetro.

Se true, faz o compilador comentários de documentação do processo em arquivos de código de origem e para criar um arquivo de .xdc para cada arquivo de código-fonte que tenha comentários de documentação.

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

IgnoreStandardIncludePath

Opcional Boolean parâmetro.

Se true, impede que o compilador procure por arquivos de inclusão nas pastas especificadas no caminho e incluir variáveis de ambiente.

Para obter mais informações, consulte /X (Ignorar padrão incluem 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 o alguma função chama com intrínseca ou caso contrário os formulários especiais da função que ajudam o seu aplicativo são executados 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, o que determina se os arquivos de origem do C++ incluem alterados C++ definições (armazenadas nos arquivos de cabeçalho (. h)) de classe 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 compilação. 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). Consulte também o ProcessorNumber parâmetro na tabela.

ObjectFileName

Opcional String parâmetro.

Especifica um nome de arquivo de 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 correto da biblioteca.

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 chamada.

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 (Ativar 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). Consulte também o PrecompiledHeaderFile e PrecompiledHeaderOutputFile parâmetros na 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 o qual o PreprocessToFile parâmetro grava pré-processado saída.

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 (Preprocess para 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é-processar 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 de arquivo de banco de dados do 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 /LD /MD, /MT, (biblioteca Run-Time uso).

RuntimeTypeInfo

Opcional Boolean parâmetro.

Se true, adiciona código para verificar os tipos de objeto C++ em tempo de execução (informações de tipo em 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 com que 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, que reporta um erro de tempo de execução, se um valor é atribuído a um tipo de dados menor e causa uma perda de dados.

Para obter mais informações, consulte o /RTCc opção na / RTC (verificações de erro de 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, que 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 do número de versão e copyright mensagem quando inicia a tarefa.

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 rastreamento para esta tarefa.

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

TreatSpecificWarningsAsErrors

Opcional String[] parâmetro.

Trata a lista especificada de avisos do compilador como erros.

Para obter mais informações, consulte o /wen opção na /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 opção na /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso).

TreatWChar_tAsBuiltInType

Opcional Boolean parâmetro.

Se true, trate o wchar_t o 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 opção na / 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 opção na / U, /u (cancele símbolos).

UseFullPaths

Opcional Boolean parâmetro.

Se true, que exibe o caminho completo de arquivos de código-fonte passadas 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 a ser criado no formato UTF-8.

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

WarningLevel

Opcional String parâmetro.

Especifica o maior nível de aviso é 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 em /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / ganhou (nível de aviso).

WholeProgramOptimization

Opcional Boolean parâmetro.

Se true, que 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 no /doc (processo documentação comentários) (C/C++). Consulte também o GenerateXMLDocumentationFiles parâmetro na tabela.

MinimalRebuildFromTracking

Opcional Boolean parâmetro.

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

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 na 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 na tabela.

TrackFileAccess

Opcional Boolean parâmetro.

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

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

Consulte também

Outros recursos

Referência de tarefa do MSBuild

Histórico de alterações

Date

History

Motivo

Setembro de 2010

Adicionado Equivalências de opção de parâmetro/linha de comando da tarefa para AssemblerOutput, BasicRuntimeChecks, CallingConvention, e CompileAs.

Comentários do cliente.

Agosto de 2010

Arquivo de leitura definido e logs de controle de gravação de arquivo (.tlog).

Comentários do cliente.