Compartilhar via

CSC tarefa

  • Artigo

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

Parâmetros

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

Parâmetro

Descrição

AdditionalLibPaths

Opcional String[] parâmetro.

Especifica diretórios adicionais para procurar por referências. Para obter mais informações, consulte /lib ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

AddModules

Opcional String parâmetro.

Especifica um ou mais módulos para ser parte do assembly. Para obter mais informações, consulte /addmodule ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

AllowUnsafeBlocks

Opcional Boolean parâmetro.

Se true, compila o código que usa o inseguros palavra-chave. Para obter mais informações, consulte /unsafe ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

ApplicationConfiguration

Opcional String parâmetro.

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

BaseAddress

Opcional String parâmetro.

Especifica o endereço base preferido no qual carregar uma DLL. O endereço de base padrão para uma DLL é definido pelo .NET Framework common language runtime. Para obter mais informações, consulte /BaseAddress ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

CheckForOverflowUnderflow

Opcional Boolean parâmetro.

Especifica se inteiro aritmético que excede os limites do tipo de dados faz com que uma exceção em tempo de execução. Para obter mais informações, consulte /Checked ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

CodePage

Opcional Int32 parâmetro.

Especifica a página de código a ser usado para todos os arquivos de código-fonte em que a compilação. Para obter mais informações, consulte /codepage ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

DebugType

Opcional String parâmetro.

Especifica o tipo de depuração. DebugTypecan be full or pdbonly. O padrão é full, que permite que um depurador a ser anexado a um programa em execução. Especificando pdbonly permite que o código-fonte, depuração quando o programa é iniciado no depurador, mas só exibe assembler quando o programa em execução está anexado ao depurador.

Esse parâmetro substitui a EmitDebugInformation parâmetro.

Para obter mais informações, consulte /<>>de depuração ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

DefineConstants

Opcional String parâmetro.

Define os símbolos de pré-processamento. Para obter mais informações, consulte /Define ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

DelaySign

Opcional Boolean parâmetro.

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

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

Para obter mais informações, consulte /DelaySign ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

DisabledWarnings

Opcional String parâmetro.

Especifica a lista de avisos para ser desativado. Para obter mais informações, consulte /nowarn ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

DocumentationFile

Opcional String parâmetro.

Processa os comentários da documentação para um arquivo XML. Para obter mais informações, consulte /doc ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

EmitDebugInformation

Opcional Boolean parâmetro.

Se true, a tarefa gera informações de depuração e o coloca em um arquivo de banco de dados (. PDB) do programa. Se false, a tarefa emite nenhum informações de depuração. O padrão é false. Para obter mais informações, consulte /<>>de depuração ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

ErrorReport

Opcional String parâmetro.

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

FileAlignment

Opcional Int32 parâmetro.

Especifica o tamanho das seções no arquivo de saída. Para obter mais informações, consulte /filealign ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

GenerateFullPaths

Opcional Boolean parâmetro.

Se true, especifica o caminho absoluto para o arquivo de saída do compilador. Se false, especifica o nome do arquivo. O padrão é false. Para obter mais informações, consulte /fullpaths ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

KeyContainer

Opcional String parâmetro.

Especifica o nome do recipiente de chave de criptografia. Para obter mais informações, consulte /keycontainer ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

KeyFile

Opcional String parâmetro.

Especifica o nome do arquivo que contém a chave criptográfica. Para obter mais informações, consulte /keyfile ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

LangVersion

Opcional String parâmetro.

Especifica a versão do idioma a ser usado. Para obter mais informações, consulte /langversion ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

LinkResources

Opcional ITaskItem[] parâmetro.

Cria um vínculo com uma .NET Framework o recurso no arquivo de saída; o arquivo de recurso não é colocado no arquivo de saída.

Os itens passados para este parâmetro podem ter entradas de metadados opcionais chamadas LogicalName e Access. LogicalNamecorresponde do identifier parâmetro da /linkresource Alternar, e Access corresponde à accessibility-modifier parâmetro. Para obter mais informações, consulte /linkresource ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

MainEntryPoint

Opcional String parâmetro.

Especifica o local da Main método. Para obter mais informações, consulte /Main ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

ModuleAssemblyName

Opcional String parâmetro.

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

NoConfig

Opcional Boolean parâmetro.

Se true, que informa o compilador não compilar com o arquivo csc.rsp. Para obter mais informações, consulte /noconfig ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

NoLogo

Opcional Boolean parâmetro.

Se true, suprime a exibição de informações de faixa do compilador. Para obter mais informações, consulte /nologo ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

NoStandardLib

Opcional Boolean parâmetro.

Se true, que impede a importação de mscorlib. dll, que define o espaço para nome inteiro do sistema. Use esse parâmetro se você quiser definir ou criar seus próprios objetos e o namespace System. Para obter mais informações, consulte /nostdlib ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

NoWin32Manifest

Opcional Boolean parâmetro.

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

Optimize

Opcional Boolean parâmetro.

Se true, que permite que otimizações. Se false, que desabilita otimizações. Para obter mais informações, consulte /<>>otimizar ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

OutputAssembly

Opcional String parâmetro de saída.

Especifica o nome do arquivo de saída. Para obter mais informações, consulte /out ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

PdbFile

Opcional String parâmetro.

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

Opcional String parâmetro.

Especifica a plataforma de processador será alvo de um arquivo de saída. Este parâmetro pode ter um valor de x86, x64, ou anycpu. O padrão é anycpu. Para obter mais informações, consulte /<>plataforma de>( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

References

Opcional ITaskItem[] parâmetro.

Faz com que a tarefa para importar informações de tipo público de itens especificados para o projeto atual. Para obter mais informações, consulte /Reference ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

Você pode especificar um Visual C# referência de alias em um MSBuild arquivo adicionando os metadados Aliases para a original "referência" item. Por exemplo, para definir o alias "ls1" na seguinte linha de comando do CSC:

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

Você usaria:

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

Resources

Opcional ITaskItem[] parâmetro.

Incorpora um .NET Framework o recurso no arquivo de saída.

Os itens passados para este parâmetro podem ter entradas de metadados opcionais chamadas LogicalName e Access. LogicalNamecorresponde do identifier parâmetro da /resource Alternar, e Access corresponde à accessibility-modifier parâmetro. Para obter mais informações, consulte /<>o recurso de>( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

ResponseFiles

Opcional String parâmetro.

Especifica o arquivo de resposta que contém comandos para esta tarefa. Para obter mais informações, consulte @ (TRANSLATION FROM VPE FOR CSHARP compilador Opções).

Sources

Opcional ITaskItem[] parâmetro.

Especifica um ou mais Visual C# arquivos de origem.

TargetType

Opcional String parâmetro.

Especifica o formato de arquivo 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 obter mais informações, consulte /<>>de destino ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

TreatWarningsAsErrors

Opcional Boolean parâmetro.

Se true, que trata todos os avisos como erros. Para obter mais informações, consulte /warnaserror ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

UseHostCompilerIfAvailable

Opcional Boolean parâmetro.

Instrui a tarefa para usar o objeto do compilador em processo, se disponível. Usado somente pelo Visual Studio.

Utf8Output

Opcional Boolean parâmetro.

Compilador de logs de saída usando a codificação UTF-8. Para obter mais informações, consulte /utf8output (TRANSLATION FROM VPE FOR CSHARP compilador Opções).

WarningLevel

Opcional Int32 parâmetro.

Especifica o nível de aviso do compilador para exibir. Para obter mais informações, consulte /warn ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

WarningsAsErrors

Opcional String parâmetro.

Especifica uma lista de avisos para tratar como erros. Para obter mais informações, consulte /warnaserror ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

Esse parâmetro substitui a TreatWarningsAsErrors parâmetro.

WarningsNotAsErrors

Opcional String parâmetro.

Especifica uma lista de avisos que não são tratados como erros. Para obter mais informações, consulte /warnaserror ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP).

Este parâmetro é útil apenas se o TreatWarningsAsErrors parâmetro for definido como true.

Win32Icon

Opcional String parâmetro.

Insere um arquivo. ico no assembly, que fornece o arquivo de saída a aparência desejada no Windows Explorer. Para obter mais informações, consulte /win32icon (TRANSLATION FROM VPE FOR CSHARP compilador Opções).

Win32Manifest

Opcional String parâmetro.

Especifica o manifesto Win32 para ser incluído.

Win32Resource

Opcional String parâmetro.

Insere um arquivo de recurso (. res) do Win32 no arquivo de saída. Para obter mais informações, consulte /win32res (TRANSLATION FROM VPE FOR CSHARP compilador Opções).

Comentários

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

Exemplo

O exemplo a seguir usa a Csc tarefa para compilar os arquivos de origem em um executável do Compile item coleção.

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

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild