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 de 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 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 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 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 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 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 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 C#).

DefineConstants

Parâmetro opcional de String .

Define símbolos pré-processamento. Para mais informações, consulte /define (opções do compilador 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 C#).

DisabledWarnings

Parâmetro opcional de String .

Especifica a lista de avisos ser desativado. Para mais informações, consulte /nowarn (opções do compilador 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 ToolTaskExtension (base).

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 das tarefas do MSBuild