Compartilhar via

Tarefa CSC

  • Artigo

As envolve CSC.exe, e geram arquivos executáveis (.exe), bibliotecas de vínculo dinâmico (arquivos.dll), ou (módulos de código.arquivos de netmodule).Para obter mais informações sobre CSC.exe, consulte Opções do compilador C#.

Parâmetros

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

Parâmetro

Descrição

AdditionalLibPaths

Parâmetro opcional de String[] .

Especifica diretórios adicionais para procurar por referências.Para mais informações, consulte /lib (Opções do compilador de C#).

AddModules

Parâmetro opcional de String .

Especifica um ou vários módulos para ser parte do assembly.Para mais informações, consulte /addmodule (Opções do compilador de C#).

AllowUnsafeBlocks

Parâmetro opcional de Boolean .

Se true, compila o código que utiliza a palavra-chave de não seguro .Para mais informações, consulte /unsafe (Opções do compilador de C#).

ApplicationConfiguration

Parâmetro opcional de String .

Especifica o arquivo de configuração do aplicativo que contém as configurações de associação de assembly.

BaseAddress

Parâmetro opcional de String .

Especifica o endereço básico preferido para carregar uma DLL.O endereço básico padrão para uma DLL é definido no common language runtime .NET Framework .Para mais informações, consulte /BaseAddress (Opções do compilador de C#).

CheckForOverflowUnderflow

Parâmetro opcional de Boolean .

Especifica se a aritmética de inteiros que transborda os limites do tipo de dados causa uma exceção em tempo de execução.Para mais informações, consulte /Checked (Opções do compilador de C#).

CodePage

Parâmetro opcional de Int32 .

Especifica a página de código para usar o para todos os arquivos de código-fonte na compilação.Para mais informações, consulte /codepage (Opções do compilador de C#).

DebugType

Parâmetro opcional de String .

Especifica o tipo de depuração.DebugType pode ser full ou pdbonly.O padrão é full, que permite que um depurador a ser anexado a um programa em execução.Especificar pdbonly permite a depuração de código fonte quando o programa é iniciado no depurador, mas somente exibe o assembler quando o programa em execução é anexado ao depurador.

Este parâmetro substitui o parâmetro de EmitDebugInformation .

Para mais informações, consulte /Debug (Opções do compilador de C#).

DefineConstants

Parâmetro opcional de String .

Define símbolos pré-processamento.Para mais informações, consulte /Define (Opções do compilador de C#).

DelaySign

Parâmetro opcional de Boolean .

Se true, especifica que você deseja um assembly totalmente assinado.Se false, especifica que você deseja somente para colocar a chave pública do assembly.

Este parâmetro não tem efeito a menos que usado com KeyFile ou parâmetro de KeyContainer .

Para mais informações, consulte /delaysign (Opções do compilador de C#).

DisabledWarnings

Parâmetro opcional de String .

Especifica a lista de avisos ser desativado.Para mais informações, consulte /nowarn (Opções do compilador de C#).

DocumentationFile

Parâmetro opcional de String .

Processa os comentários da documentação para um arquivo XML.Para mais informações, consulte /doc (Opções do compilador de C#).

EmitDebugInformation

Parâmetro opcional de Boolean .

Se true, a tarefa gerar informações de depuração e o coloca em um arquivo de banco de dados do programa (.pdb).Se false, a tarefa não emite se nenhuma informação de depuração.O padrão é false.Para mais informações, consulte /Debug (Opções do compilador de C#).

ErrorReport

Parâmetro opcional de String .

Fornece uma maneira conveniente para relatar um erro interno do C# a Microsoft.Este parâmetro pode ter um valor de prompt, de send, ou de none.Se o parâmetro for definido como prompt, você receberá um aviso quando ocorrer um erro interno do compilador.O aviso permite que você envie eletronicamente um relatório de erros a Microsoft.Se o parâmetro for definido como send, um relatório de erros é enviado automaticamente.Se o parâmetro for definido como none, o erro é relatado somente na saída de texto do compilador.O padrão é none.Para mais informações, consulte /ErrorReport (Opções do compilador de C#).

FileAlignment

Parâmetro opcional de Int32 .

Especifica o tamanho das seções no arquivo de saída.Para mais informações, consulte /filealign (Opções do compilador de C#).

GenerateFullPaths

Parâmetro opcional de Boolean .

Se true, especifica o caminho absoluto para o arquivo na saída do compilador.Se false, especifica o nome do arquivo.O padrão é false.Para mais informações, consulte /fullpaths (Opções do compilador de C#).

KeyContainer

Parâmetro opcional de String .

Especifica o nome do contêiner de chave de criptografia.Para mais informações, consulte /keycontainer (Opções do compilador de C#).

KeyFile

Parâmetro opcional de String .

Especifica o nome de arquivo que contém a chave de criptografia.Para mais informações, consulte /keyfile (Opções do compilador de C#).

LangVersion

Parâmetro opcional de String .

Especifica a versão da linguagem para usar.Para mais informações, consulte /langversion (Opções do compilador de C#).

LinkResources

Parâmetro opcional de ITaskItem[] .

Criar um link a um recurso de .NET Framework no arquivo de saída; o arquivo de recursos não é colocado no arquivo de saída.

Os itens passados em este parâmetro podem ter as entradas de metadados opcionais chamadas LogicalName e Access.LogicalName corresponde ao parâmetro de identifier a opção de /linkresource , e Access corresponde ao parâmetro de accessibility-modifier .Para mais informações, consulte /linkresource (Opções do compilador de C#).

MainEntryPoint

Parâmetro opcional de String .

Especifica o local do método de Main .Para mais informações, consulte /Main (Opções do compilador de C#).

ModuleAssemblyName

Parâmetro opcional de String .

Especifica o nome do conjunto de módulos (assembly) de que este módulo será uma parte.

NoConfig

Parâmetro opcional de Boolean .

Se true, informa que o compilador não deve compilar com o arquivo de csc.rsp.Para mais informações, consulte /noconfig (Opções do compilador de C#).

NoLogo

Parâmetro opcional de Boolean .

Se true, suprime a exibição das informações de cabeçalho de compilador.Para mais informações, consulte /nologo (Opções do compilador de C#).

NoStandardLib

Parâmetro opcional de Boolean .

Se true, a importação mscorlib.dll, que define o namespace inteiro do sistema.Use este parâmetro se você desejar definir ou criar seus próprios namespace e objetos do sistema.Para mais informações, consulte /nostdlib (Opções do compilador de C#).

NoWin32Manifest

Parâmetro opcional de Boolean .

Se true, não inclui o manifesto Win32 padrão.

Optimize

Parâmetro opcional de Boolean .

Se true, ativar otimizações.Se false, otimizações desativa.Para mais informações, consulte /Optimize (Opções do compilador de C#).

OutputAssembly

Parâmetro de saída de String opcional.

Especifica o nome do arquivo de saída.Para mais informações, consulte /out (Opções do compilador de C#).

PdbFile

Parâmetro opcional de String .

Especifica o nome do arquivo de informações de depuração.O nome padrão é o nome do arquivo de saída com uma extensão de .pdb.

Platform

Parâmetro opcional de String .

Especifica a plataforma do processador a ser destinada pelo arquivo de saída.Este parâmetro pode ter um valor de x86, de x64, ou de anycpu.O padrão é anycpu.Para mais informações, consulte /Platform (Opções do compilador de C#).

References

Parâmetro opcional de ITaskItem[] .

Faz com que a tarefa importar informações pública do tipo dos itens especificados no projeto atual.Para mais informações, consulte /Reference (Opções do compilador de C#).

Você pode especificar um alias de referência de Visual C# em um arquivo de MSBuildadicionando os metadados Aliases ao item original de referência “”.Por exemplo, para definir o alias “LS1” na linha de comando CSC:

csc /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs

você usar-se-ia:

<Reference Include="MyCodeLibrary">
  <Aliases>LS1</Aliases>
</Reference>

Resources

Parâmetro opcional de ITaskItem[] .

Insere um recurso de .NET Framework no arquivo de saída.

Os itens passados em este parâmetro podem ter as entradas de metadados opcionais chamadas LogicalName e Access.LogicalName corresponde ao parâmetro de identifier a opção de /resource , e Access corresponde ao parâmetro de accessibility-modifier .Para mais informações, consulte /Resource (Opções do compilador de C#).

ResponseFiles

Parâmetro opcional de String .

Especifica o arquivo de resposta que contém comandos para esta tarefa.Para mais informações, consulte @ (Opções do compilador de C#).

Sources

Parâmetro opcional de ITaskItem[] .

Especifica um ou mais arquivos de origem de Visual C# .

TargetType

Parâmetro opcional de String .

Especifica o formato do arquivo de saída.Este parâmetro pode ter um valor de 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 mais informações, consulte /Target (Opções do compilador de C#).

TreatWarningsAsErrors

Parâmetro opcional de Boolean .

Se true, deleites todos os avisos como erros.Para mais informações, consulte /warnaserror (Opções do compilador de C#).

UseHostCompilerIfAvailable

Parâmetro opcional de Boolean .

Instrui a tarefa usar o objeto para processo de compilador, se disponível.Usado somente por Visual Studio.

Utf8Output

Parâmetro opcional de Boolean .

Efetua logon saída do compilador usando a codificação UTF-8.Para mais informações, consulte /utf8output (Opções do compilador de C#).

WarningLevel

Parâmetro opcional de Int32 .

Especifica o nível de aviso para o compilador exibe.Para mais informações, consulte /Warn (Opções do compilador de C#).

WarningsAsErrors

Parâmetro opcional de String .

Especifica uma lista de tratar avisos como erros.Para mais informações, consulte /warnaserror (Opções do compilador de C#).

Este parâmetro substitui o parâmetro de TreatWarningsAsErrors .

WarningsNotAsErrors

Parâmetro opcional de String .

Especifica uma lista de avisos que não são tratados como erros.Para mais informações, consulte /warnaserror (Opções do compilador de C#).

Esse parâmetro é útil somente se o parâmetro de TreatWarningsAsErrors é definido como true.

Win32Icon

Parâmetro opcional de String .

Insere um arquivo .ico no assembly, que fornece o arquivo de saída a aparência desejada em Arquivo Explorer.Para mais informações, consulte /win32icon (Opções do compilador de C#).

Win32Manifest

Parâmetro opcional de String .

Especifica o manifesto Win32 a ser incluído.

Win32Resource

Parâmetro opcional de String .

Insere um arquivo de recurso Win32 (.res) no arquivo de saída.Para mais informações, consulte /win32res (Opções do compilador de C#).

Comentários

Além dos parâmetros listados acima, esta tarefa parâmetros herda da classe de Microsoft.Build.Tasks.ManagedCompiler , que herda da classe de ToolTaskExtension própria, que herda da classe de ToolTask .Para obter uma lista de esses parâmetros adicionais e suas descrições, consulte Classe Base ToolTaskExtension.

Exemplo

O exemplo a seguir usa a tarefa de Csc criar um executável dos arquivos de origem na coleção de item de Compile .

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

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild