tarefa Csc

Encapsula csc.exe e produz executáveis (arquivos .exe), bibliotecas de vínculo dinâmico (arquivos .dll) ou módulos de código (arquivos .netmodule). Para obter mais informações sobre o csc.exe, confira Opções do compilador C#.

Parâmetros

A tabela a seguir descreve os parâmetros da tarefa Csc.

Parâmetro	Descrição
AdditionalLibPaths	Parâmetro String[] opcional. Especifica diretórios adicionais para pesquisar referências. Para obter mais informações, confira -lib (opções do compilador C#).
AddModules	Parâmetro String opcional. Especifica um ou mais módulos a fazerem parte do assembly. Para obter mais informações, confira -addmodule (opções do compilador C#).
AllowUnsafeBlocks	Parâmetro Boolean opcional. Se for true, compilará o código que usa a palavra-chave unsafe. Para obter mais informações, confira -unsafe (opções do compilador C#).
ApplicationConfiguration	Parâmetro String opcional. Especifica um arquivo de configuração de aplicativo que contém configurações de associação de assembly.
BaseAddress	Parâmetro String opcional. Especifica o endereço básico preferencial no qual uma DLL será carregada. O endereço básico padrão de uma DLL é definido pelo Common Language Runtime do .NET Framework. Para obter mais informações, confira -baseaddress (opções do compilador C#).
CheckForOverflowUnderflow	Parâmetro Boolean opcional. Especifica se o aritmético inteiro que estoura os limites do tipo de dados causa uma exceção em tempo de execução. Para obter mais informações, confira -checked (opções do compilador C#).
ChecksumAlgorithm	Parâmetro String opcional. Especifica o algoritmo para calcular a soma de verificação do arquivo de origem armazenada no arquivo PDB. O algoritmo deve ser SHA1 (padrão) ou SHA256. Consulte ChecksumAlgorithm.
CodeAnalysisRuleset	Parâmetro String opcional. Especifica um arquivo de conjunto de regras que desabilita o diagnóstico específico. Consulte CodeAnalysisRuleset.
CodePage	Parâmetro Int32 opcional. Especifica a página de código a ser usada para todos os arquivos de código-fonte na compilação. Para obter mais informações, confira -codepage (opções do compilador C#).
DebugType	Parâmetro String opcional. Especifica o tipo de depuração. DebugType pode ser full ou pdbonly. O padrão é full, o que permite que um depurador seja anexado a um programa em execução. Especificar pdbonly habilita a depuração de código-fonte quando o programa é iniciado no depurador, mas apenas exibe o assembler quando o programa em execução está anexado ao depurador. Esse parâmetro substitui o parâmetro EmitDebugInformation. Para obter mais informações, confira -debug (opções do compilador C#).
DefineConstants	Parâmetro String opcional. Define símbolos do pré-processador. Para obter mais informações, confira -define (opções do compilador C#).
DelaySign	Parâmetro Boolean opcional. Se for true, especificará que você apenas deseja colocar a chave pública no assembly. Se for false, especificará que você deseja um assembly totalmente assinado Esse parâmetro não terá nenhum efeito a menos que seja usado com o parâmetro KeyFile ou KeyContainer. Para obter mais informações, confira -delaysign (opções do compilador C#).
Deterministic	Parâmetro Boolean opcional. Se ele for true, fará com que o compilador gere um assembly cujo conteúdo binário é idêntico entre compilações caso as entradas sejam idênticas. Para obter mais informações, confira -deterministic (opções do compilador C#).
DisabledWarnings	Parâmetro String opcional. Especifica a lista de avisos a ser desabilitada. Para obter mais informações, confira -nowarn (opções do compilador C#).
DocumentationFile	Parâmetro String opcional. Processa comentários de documentação para um arquivo XML. Para obter mais informações, confira -doc (opções do compilador C#).
EmbedAllSources	Parâmetro Boolean opcional. Insere todos os arquivos de origem no PDB. Para obter mais informações, consulte -embed (opções do compilador C#)
EmitDebugInformation	Parâmetro Boolean opcional. Se for true, a tarefa gerará informações de depuração e as colocará em um arquivo de banco de dados do programa (.pdb). Se for false, a tarefa não emitirá nenhuma informação de depuração. O padrão é false. Para obter mais informações, confira -debug (opções do compilador C#).
ErrorLog	Parâmetro String opcional. Especifica um arquivo para registrar todos os diagnósticos do compilador e do analisador. Consulte ErrorLog.
ErrorReport	Parâmetro String opcional. Fornece uma maneira conveniente de relatar um erro interno do C# à Microsoft. Esse parâmetro pode ter um valor igual a prompt, send ou none. Se o parâmetro for definido como prompt, você receberá um prompt quando ocorrer um erro interno do compilador. O prompt permite enviar um relatório de bugs eletronicamente à Microsoft. Se o parâmetro for definido como send, um relatório de bugs será enviado automaticamente. Se o parâmetro for definido como none, o erro será relatado apenas na saída de texto do compilador. O padrão é none. Para obter mais informações, confira -errorreport (opções do compilador C#).
FileAlignment	Parâmetro Int32 opcional. Especifica o tamanho das seções no arquivo de saída. Para obter mais informações, confira -filealign (opções do compilador C#).
GenerateFullPaths	Parâmetro Boolean opcional. Se for true, especificará o caminho absoluto para o arquivo na saída do compilador. Se for false, especificará o nome do arquivo. O padrão é false. Para obter mais informações, confira -fullpaths (opções do compilador C#).
HighEntropyVA	Parâmetro opcional Boolean Habilitar a ASLR (Randomização de Layout de Espaço de Endereço) de alta entropia. Consulte HighEntropyVA.
KeyContainer	Parâmetro String opcional. Especifica o nome do contêiner da chave de criptografia. Para obter mais informações, confira -keycontainer (opções do compilador C#).
KeyFile	Parâmetro String opcional. Especifica o nome de arquivo que contém a chave de criptografia. Para obter mais informações, confira -keyfile (opções do compilador C#).
LangVersion	Parâmetro String opcional. Especifica a versão da linguagem a ser usada. Para obter mais informações, confira -langversion (opções do compilador C#).
LinkResources	Parâmetro opcional ITaskItem[]. Cria um link para um recurso do .NET Framework no arquivo de saída; o arquivo de recurso não é colocado no arquivo de saída. Os itens passados para esse parâmetro podem ter entradas de metadados opcionais chamadas LogicalName e Access. LogicalName corresponde ao parâmetro identifier da opção /linkresource e Access corresponde ao parâmetro accessibility-modifier. Para obter mais informações, confira -linkresource (opções do compilador C#).
MainEntryPoint	Parâmetro String opcional. Especifica o local do método Main. Para obter mais informações, confira -main (opções do compilador C#).
ModuleAssemblyName	Parâmetro String opcional. Especifica o nome do assembly do qual esse módulo fará parte.
NoConfig	Parâmetro Boolean opcional. Se ele for true, instruirá o compilador a não compilar com o arquivo csc.rsp. Para obter mais informações, confira -noconfig (opções do compilador C#).
NoLogo	Parâmetro Boolean opcional. Se for true, suprimirá a exibição de informações da barra de notificação do compilador. Para obter mais informações, confira -nologo (opções do compilador C#).
NoStandardLib	Parâmetro Boolean opcional. Se for true, impedirá a importação de mscorlib.dll, que define todo o namespace System. Use esse parâmetro se desejar definir ou criar seus próprios objetos e namespace System. Para obter mais informações, confira -nostdlib (opções do compilador C#).
NoWin32Manifest	Parâmetro Boolean opcional. Se for true, não inclua o manifesto Win32 padrão.
Nullable	Parâmetro String opcional. Especifica o contexto anulável. O argumento deve enable, disable, warnings ou annotations. Consulte Anulável.
Optimize	Parâmetro Boolean opcional. Se for true, habilitará as otimizações. Se for false, desabilitará as otimizações. Para obter mais informações, confira -optimize (opções do compilador C#).
OutputAssembly	Parâmetro de saída String opcional. Especifica o nome do arquivo de saída. Para obter mais informações, confira -out (opções do compilador C#).
OutputRefAssembly	Parâmetro String opcional. Especifica o nome do arquivo do assembly de referência de saída. Para obter mais informações, confira -refout (opções do compilador C#).
PathMap	Parâmetro String opcional. Especifica como mapear caminhos físicos para nomes de caminho de origem emitidos pelo compilador. Consulte PathMap.
PdbFile	Parâmetro String opcional. Especifica o nome de arquivo de informações de depuração. O nome padrão é o nome do arquivo de saída com uma extensão .pdb.
Platform	Parâmetro String opcional. Especifica a plataforma do processador a ser direcionada pelo arquivo de saída. Esse parâmetro pode ter um valor igual a x86, x64 ou anycpu. O padrão é anycpu. Para obter mais informações, confira -platform (opções do compilador C#).
PreferredUILang	Parâmetro String opcional. Especifica o idioma em que o compilador do C# exibe a saída, como mensagens de erro. Consulte PreferredUILang.
PublicSign	Parâmetro Boolean opcional. Assinar publicamente o assembly de saída. Consulte PublicSign.
References	Parâmetro opcional ITaskItem[]. Faz com que a tarefa importe informações de tipo público dos itens especificados para o projeto atual. Para obter mais informações, confira -reference (opções do compilador C#). Você pode especificar um alias de referência do C# em um arquivo do MSBuild adicionando os Aliases de metadados ao item original da "Referência". Por exemplo, para definir o alias "LS1" na seguinte linha de comando Csc: CSC /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs você usará: <Reference Include="MyCodeLibrary"> <Aliases>LS1</Aliases> </Reference>
RefOnly	Parâmetro Boolean opcional. Produzir um assembly de referência, em vez de um assembly completo, como a saída primária. Consulte ProduceOnlyReferenceAssembly.
ReportAnalyzer	Parâmetro Boolean opcional. Reporte informações adicionais do analisador, como o tempo de execução. Consulte ReportAnalyzer.
Resources	Parâmetro opcional ITaskItem[]. Insere um recurso do .NET Framework no arquivo de saída. Os itens passados para esse parâmetro podem ter entradas de metadados opcionais chamadas LogicalName e Access. LogicalName corresponde ao parâmetro identifier da opção /resource e Access corresponde ao parâmetro accessibility-modifier. Para obter mais informações, confira -resource (opções do compilador C#).
ResponseFiles	Parâmetro String opcional. Especifica o arquivo de resposta que contém comandos para essa tarefa. Para obter mais informações, confira @ (Especificar arquivo de resposta).
Sources	Parâmetro opcional ITaskItem[]. Especifica um ou mais arquivos de origem do C#.
TargetType	Parâmetro String opcional. Especifica o formato do arquivo de saída. Esse parâmetro pode ter um valor igual a library, que cria uma biblioteca de códigos, exe, que cria um aplicativo de console, module, que cria um módulo ou winexe, que cria um programa do Windows. O valor padrão é library. Para obter mais informações, confira -target (opções do compilador C#).
TreatWarningsAsErrors	Parâmetro Boolean opcional. Se for true, tratará todos os avisos como erros. Para obter mais informações, confira -warnaserror (opções do compilador C#).
UseHostCompilerIfAvailable	Parâmetro Boolean opcional. Instrui a tarefa a usar o objeto do compilador em processo, se disponível. Usado somente pelo Visual Studio.
Utf8Output	Parâmetro Boolean opcional. Registra a saída do compilador usando a codificação UTF-8. Para obter mais informações, confira -utf8output (opções do compilador C#).
WarningLevel	Parâmetro Int32 opcional. Especifica o nível de aviso a ser exibido pelo compilador. Para obter mais informações, confira -warn (opções do compilador C#).
WarningsAsErrors	Parâmetro String opcional. Especifica uma lista de avisos a serem tratados como erros. Para obter mais informações, confira -warnaserror (opções do compilador C#). Esse parâmetro substitui o parâmetro TreatWarningsAsErrors.
WarningsNotAsErrors	Parâmetro String opcional. Especifica uma lista de avisos que não são tratados como erros. Para obter mais informações, confira -warnaserror (opções do compilador C#). Esse parâmetro será útil apenas se o parâmetro TreatWarningsAsErrors for definido como true.
Win32Icon	Parâmetro String opcional. Insere um arquivo .ico no assembly, que fornece ao arquivo de saída a aparência desejada no Explorador de Arquivos. Para obter mais informações, confira -win32icon (opções do compilador C#).
Win32Manifest	Parâmetro String opcional. Especifica o manifesto Win32 a ser incluído.
Win32Resource	Parâmetro String opcional. Insere um arquivo (.res) do recurso do Win32 no arquivo de saída. Para obter mais informações, confira -win32res (opções do compilador C#).

Parâmetros de ToolTaskExtension

Essa tarefa herda da classe ToolTaskExtension, que herda da classe ToolTask, que por sua vez herda da classe Task. Esta cadeia de herança adiciona vários parâmetros nas tarefas que derivam deles.

A seguinte tabela descreve os parâmetros das classes base:

Parâmetro	Descrição
EchoOff	Parâmetro bool opcional. Quando definido como true, essa tarefa passa /Q para a linha de comando de cmd.exe, de modo que a linha de comando não é copiada para stdout.
EnvironmentVariables	Parâmetro de matriz String opcional. Matriz de definições da variável de ambiente, separadas por ponto e vírgula. Cada definição deve especificar um nome da variável de ambiente e um valor separados por um sinal de igual. Essas variáveis são passadas para o executável gerado além, ou seletivamente substituindo, o bloco de ambiente regular. Por exemplo, Variable1=Value1;Variable2=Value2.
ExitCode	Parâmetro de saída opcional somente leitura Int32. Especifica o código de saída fornecido pelo comando executado. Se a tarefa registra erros, mas o processo tem um código de saída de 0 (êxito), isso é definido como -1.
LogStandardErrorAsError	Parâmetro bool opcional. Se true, todas as mensagens recebidas no fluxo de erro padrão são registradas como erros.
StandardErrorImportance	Parâmetro String opcional. a importância com a qual o texto do fluxo de erro padrão deve ser registrado.
StandardOutputImportance	Parâmetro String opcional. Importância para fazer o texto de log do fluxo de saída do padrão.
Timeout	Parâmetro Int32 opcional. Especifica a quantidade de tempo em milissegundos após o qual o executável da tarefa é encerrado. O valor padrão é Int.MaxValue, indicando que não há período de tempo limite. O tempo limite está em milissegundos.
ToolExe	Parâmetro string opcional. Projetos podem implementar para substituir um ToolName. Tarefas podem substituir isso para preservar o ToolName.
ToolPath	Parâmetro string opcional. Especifica o local de onde a tarefa carrega o arquivo executável subjacente. Se esse parâmetro não for especificado, a tarefa usará o caminho de instalação do SDK correspondente à versão da estrutura que está executando o MSBuild.
UseCommandProcessor	Parâmetro bool opcional. Quando definido como true, essa tarefa cria um arquivo em lotes para a linha de comando e o executa usando o processador de comando em vez de executar o comando diretamente.
YieldDuringToolExecution	Parâmetro bool opcional. Quando definido como true, essa tarefa gera o nó quando a tarefa está em execução.

Exemplo

O exemplo a seguir usa a tarefa Csc para compilar um executável com base nos arquivos de origem da coleção de itens Compile.

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

Confira também

• Referência de tarefas
• Tarefas