Tarefa CSC
Empacota CSC.exe e produz arquivos 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 CSC.exe, consulte Opções do Compilador C#.
Parâmetros
A tabela a seguir descreve os parâmetros do Csc tarefa.
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 (especificar assembly referência locais) (opções do compilador de C#). |
AddModules |
Opcional String parâmetro. Especifica um ou mais módulos de fazer parte do assembly. Para obter mais informações, consulte /addmodule (importar metadados) (opções do compilador de C#). |
AllowUnsafeBlocks |
Opcional Boolean parâmetro. If true, compila o código que usa o não seguro palavra-chave. Para obter mais informações, consulte /unsafe (permitir sem segurança modo) (opções do compilador de C#). |
BaseAddress |
Opcional String parâmetro. Especifica o endereço básico preferido no qual carregar uma DLL. O endereço básico padrão para uma DLL é conjunto pelo .NET Framework Common linguagem tempo de execução. Para obter mais informações, consulte /baseaddress (especificar base de endereço de DLL) (opções do compilador de C#). |
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 time de execução. Para obter mais informações, consulte / Marcado (Verificação inteiro Arithmetic) (opções do compilador de C#). |
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 (especificar Página de código) para arquivos de código de origem (opções Compiler C#) . |
DebugType |
Opcional String parâmetro. Especifica o tipo de depurar. DebugType pode ser full ou pdbonly. O padrão é full, que permite que um depurador para ser anexado a um programa em execução. Especificando pdbonly Habilita a depuração de código de fonte quando o programa é iniciado no depurador, mas só exibe assembler quando o programa em execução é anexado ao depurador. Esse parâmetro substitui a EmitDebugInformation parâmetro. Para obter mais informações, consulte /Debug (emitir informações de Depurando) (opções do compilador de C#). |
DefineConstants |
Opcional String parâmetro. Define os símbolos de pré-processador. Para obter mais informações, consulte / Definir (Definir de pré-processador) (opções do compilador de C#). |
DelaySign |
Opcional Boolean parâmetro. If true, especifica que você deseja que um assembly totalmente assinado. If false, especifica que você deseja colocar a chave pública no assembly apenas. Este parâmetro não terá efeito a menos que usadas com qualquer um o KeyFile ou KeyContainer parâmetro. Para obter mais informações, consulte /delaysign (Atrasar assinatura do assembly) (opções do compilador de C#). |
DisabledWarnings |
Opcional String parâmetro. Especifica a lista de avisos a ser desabilitado. Para obter mais informações, consulte /nowarn (suprimir especificado avisos) (opções do compilador de C#). |
DocumentationFile |
Opcional String parâmetro. Processa os comentários da documentação para um arquivo XML. Para obter mais informações, consulte /doc (processo Documentação Comments) (opções do compilador de C#). |
EmitDebugInformation |
Opcional Boolean parâmetro. If true, a tarefa gera informações de depuração e coloca-o em um arquivo de banco de dados (.pdb) do programa. If false, a tarefa não emite nenhuma informação de depurar. O padrão é false. Para obter mais informações, consulte /Debug (emitir informações de Depurando) (opções do compilador de C#). |
ErrorReport |
Opcional String parâmetro. Fornece uma maneira conveniente para relatar um erro interno translation from VPE for Csharp à Microsoft. Este parâmetro pode ter um valor de prompt, send, ou none. Se o parâmetro for conjunto para prompt, você receberá um aviso quando ocorre um erro interno do compilador. O aviso permite que você enviar um relatório de bug eletronicamente para Microsoft. Se o parâmetro for conjunto para send, um relatório de erros é enviado automaticamente. Se o parâmetro for definido como none, o erro reportado apenas na saída do texto do compilador. O padrão é none. Para obter mais informações, consulte /errorreport (definir Error Reporting comportamento) (opções do compilador de C#). |
FileAlignment |
Opcional Int32 parâmetro. Especifica o dimensionar das seções no arquivo de saída. Para obter mais informações, consulte /filealign (especificar seção Alinhamento) (opções do compilador de C#). |
GenerateFullPaths |
Opcional Boolean parâmetro. If true, especifica o caminho absoluto para o arquivo na saída do compilador. If false, especifica o nome do arquivo. O padrão é false. Para obter mais informações, consulte /fullpaths (especificar totalmente qualificado caminho na saída do compilador) (opções do compilador de C#). |
KeyContainer |
Opcional String parâmetro. Especifica o nome do contêiner de chave de criptografia. Para obter mais informações, consulte /keycontainer (Especifica forte nome do recipiente de chave) (opções do compilador de C#). |
KeyFile |
Opcional String parâmetro. Especifica nome de arquivo que contém a chave de criptografia. Para obter mais informações, consulte /keyfile (Especifica forte nome do arquivo de chave) (opções do compilador de C#). |
LangVersion |
Opcional String parâmetro. Especifica a versão do linguagem a ser usado. Para obter mais informações, consulte /langversion (em conformidade com sintaxe) (opções do compilador de C#). |
LinkResources |
Opcional ITaskItem[] parâmetro. Cria um vínculo com um .NET Framework recurso no arquivo de saída; o arquivo de recurso não é colocado no arquivo de saída. Itens passadas para este parâmetro podem ter entradas de metadados opcionais chamadas LogicalName e Access. LogicalName corresponde do identifier parâmetro das /linkresource comutador, e Access corresponde ao accessibility-modifier parâmetro. Para obter mais informações, consulte /linkresource (link para recursos do .NET Framework) (opções do compilador de C#). |
MainEntryPoint |
Opcional String parâmetro. Especifica o local do Main método. Para obter mais informações, consulte /Main (especificar local do principal método) (opções do compilador de C#). |
NoConfig |
Opcional Boolean parâmetro. If true, informa o compilador não compilar com o arquivo csc.rsp. Para obter mais informações, consulte /noconfig (Ignorar csc.rsp) (opções do compilador de C#). |
NoLogo |
Opcional Boolean parâmetro. If true, suprime a exibição de informações de faixa do compilador. Para obter mais informações, consulte /nologo (Suprimir faixa de informações) (opções do compilador de C#). |
NoStandardLib |
Opcional Boolean parâmetro. If true, impede a importação de mscorlib.dll, que define o espaço para nome inteiro do sistema. Use esse parâmetro se quiser definir ou criar seu próprio namespace sistema e objetos. Para obter mais informações, consulte /nostdlib (fazer não importar biblioteca padrão) (opções do compilador de C#). |
Optimize |
Opcional Boolean parâmetro. If true, permite que otimizações. If false, desabilita otimizações. Para obter mais informações, consulte /optimize (ativar/desativar otimizações) (opções do compilador de C#). |
OutputAssembly |
Opcional String parâmetro de saída. Especifica o nome do arquivo de saída. Para obter mais informações, consulte / out (conjunto de saída Nome do Arquivo) (opções do compilador de C#). |
Platform |
Opcional String parâmetro. Especifica a plataforma de processador será alvo de 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 (especificar Saída Plataforma) (opções do compilador de C#). |
References |
Opcional ITaskItem[] parâmetro. Faz com que a tarefa importar informações de tipo público de itens especificados no projeto corrente. Para obter mais informações, consulte /Referência (importar metadados) (opções do compilador de C#). Você pode especificar um Visual C# referência de alias em um MSBuild arquivo por adicionar os metadados Aliasespara o item original da "Referência". Por exemplo, para conjunto o alias "LS1" na linha de comando a seguir CSC: Você usaria: |
Resources |
Opcional ITaskItem[] parâmetro. Incorpora um .NET Framework recurso no arquivo de saída. Itens passadas para este parâmetro podem ter entradas de metadados opcionais chamadas LogicalName e Access. LogicalName corresponde do identifier parâmetro das /resource comutador, e Access corresponde ao accessibility-modifier parâmetro. Para obter mais informações, consulte /recurso (incorporar recurso Arquivo à saída) (opções do compilador de C#). |
ResponseFiles |
Opcional String parâmetro. Especifica o arquivo de resposta que contém comandos para esta tarefa. Para obter mais informações, consulte @ (Especificar o arquivo de resposta) (opções do compilador de C#). |
Sources |
Opcional ITaskItem[] parâmetro. Especifica um ou mais Visual C# arquivos de fonte. |
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 /Destino (especificar saída Arquivo Formatar) (opções do compilador de C#). |
Timeout |
Opcional Int32 parâmetro. Especifica a quantidade de time, em milissegundos, após o qual a tarefa executável é encerrada. O valor padrão é Int.MaxValue, indicando que não há nenhum período de time limite. |
ToolPath |
Opcional String parâmetro. Especifica o local de onde a tarefa carrega o arquivo executável subjacente (CSC.exe). Se este parâmetro não for especificado, a tarefa utiliza o caminho de instalação do SDK que corresponde à versão do estrutura que está executando o MSBuild. |
TreatWarningsAsErrors |
Opcional Boolean parâmetro. If true, trata todos sistema autônomo avisos sistema autônomo erros. Para obter mais informações, consulte /warnaserror (Trata avisos como erros) (opções do compilador de C#). |
UseHostCompilerIfAvailable |
Opcional Boolean parâmetro. Instrui a tarefa para usar o objeto de compilador em processo, se disponível. Usado somente por 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 (exibir mensagens de compilador com UTF-8) (opções do compilador de C#). |
WarningLevel |
Opcional Int32 parâmetro. Especifica o nível de aviso para o compilador exibir. Para obter mais informações, consulte /Warn (especificar Aviso nível) (opções do compilador de C#). |
WarningsAsErrors |
Opcional String parâmetro. Especifica uma lista de avisos para tratar sistema autônomo erros. Para obter mais informações, consulte /warnaserror (Trata avisos como erros) (opções do compilador de C#). Esse parâmetro substitui a TreatWarningsAsErrors parâmetro. |
WarningsNotAsErrors |
Opcional String parâmetro. Especifica uma lista de avisos que não são tratados sistema autônomo erros. Para obter mais informações, consulte /warnaserror (Trata avisos como erros) (opções do compilador de C#). Este parâmetro é útil apenas se o TreatWarningsAsErrors parâmetro for definido como true. |
WarningLevel |
Opcional Int32 parâmetro. Define o nível de aviso apropriadas, de 0 a 4. Para obter mais informações, consulte /Warn (especificar Aviso nível) (opções do compilador de C#). |
Win32Icon |
Opcional String parâmetro. Insere um arquivo .ico no conjunto de módulos (assembly), que fornece o arquivo de saída a aparência desejada no Windows Explorer. Para obter mais informações, consulte / win32icon (importar um arquivo .ico) (opções do compilador de C#). |
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 (importar um Arquivo de Recursos do Win32) (opções do compilador de C#). |
Exemplo
O exemplo a seguir utiliza o Csc tarefa para compilar um executável dos arquivos de fonte na Compile coleção de itens.
<CSC
Sources="@(Compile)"
OutputAssembly="$(AppName).exe"
EmitDebugInformation="true" />