Tarefa Vbc
Envolve vbc.exe, que gera executáveis (.exe, as bibliotecas de vínculo dinâmico (.dll), ou os módulos de código (. netmodule). Para obter mais informações sobre vbc.exe, consulte Compilador de linha de comando do Visual Basic.
Parâmetros
A tabela a seguir descreve os parâmetros de tarefa de Vbc .
Parâmetro |
Descrição |
|---|---|
AdditionalLibPaths |
Parâmetro opcional de String[] . Especifica as pastas adicionais para procurar conjuntos especificado no atributo das referências. |
AddModules |
Parâmetro opcional de String[] . Faz com que o compilador torne todas as informações do tipo dos arquivos especificados disponíveis para o projeto que você está compilando atualmente. Este parâmetro corresponde ao de /addmodule opção de compilador vbc.exe. |
BaseAddress |
Parâmetro opcional de String . Especifica o endereço básico DLL. Este parâmetro corresponde ao de /baseaddress opção de compilador vbc.exe. |
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. Este parâmetro corresponde ao de /codepage opção de compilador vbc.exe. |
DebugType |
Parâmetro opcional de String[] . Faz com que o compilador gere informações de depuração. Este parâmetro pode ter os seguintes valores:
O valor padrão é full, que permite que anexar um depurador ao programa em execução. Um valor de pdbonly permite a depuração de código fonte quando o programa é iniciado no depurador, mas o código de linguagem de assembly " exibe somente quando o programa em execução é anexado ao depurador. Para mais informações, consulte /debug (Visual Basic). |
DefineConstants |
Parâmetro opcional de String[] . Define constantes condicionais de compilador. Os pares do símbolo/valor são separadas por ponto-e-vírgula e especificados com a seguinte sintaxe: symbol1=value1;symbol2=valor2 Este parâmetro corresponde ao de /define opção de compilador vbc.exe. |
DelaySign |
Parâmetro opcional de Boolean . Se true, a tarefa colocar a chave pública do assembly. Se false, a tarefa assinar totalmente o assembly. o valor padrão é false. Este parâmetro não tem efeito a menos que usado com o parâmetro de KeyFile ou o parâmetro de KeyContainer . Este parâmetro corresponde ao de /delaysign opção de compilador vbc.exe. |
DisabledWarnings |
Parâmetro opcional de String . Suprime os avisos específicos. Você só precisa especificar a parte numérica do identificador de aviso. Vários avisos são separadas por ponto-e-vírgula. Este parâmetro corresponde ao de /nowarn opção de compilador vbc.exe. |
DocumentationFile |
Parâmetro opcional de String . Processa os comentários de documentação para o arquivo XML especificado. Este parâmetro substitui o atributo de GenerateDocumentation . Para obter mais informações, consulte /doc. |
EmitDebugInformation |
Parâmetro opcional de Boolean . Se true, a tarefa gerar informações de depuração e o coloca em um arquivo de .pdb. Para mais informações, consulte /debug (Visual Basic). |
ErrorReport |
Parâmetro opcional de String . Especifica como a tarefa deve relatar erros do compilador interno. Este parâmetro pode ter os seguintes valores:
Se prompt é especificado e ocorrer um erro interno do compilador, o usuário é apresentada uma opção de wheter enviar os dados de erro à Microsoft. Se send é especificado e ocorrer um erro interno do compilador, a tarefa envia os dados de erro à Microsoft. O valor padrão é none, que analisam erros na saída de somente texto. Este parâmetro corresponde ao de /errorreport opção de compilador vbc.exe. |
FileAlignment |
Parâmetro opcional de Int32 . Especifica, em bytes, onde alinhar as seções do arquivo de saída. Este parâmetro pode ter os seguintes valores:
Este parâmetro corresponde ao de /filealign opção de compilador vbc.exe. |
GenerateDocumentation |
Parâmetro opcional de Boolean . Se true, gera informações da documentação e colocados em um arquivo XML com o nome do arquivo executável ou biblioteca que a tarefa está criando. Para obter mais informações, consulte /doc. |
Imports |
Parâmetro opcional de ITaskItem[] . Importa namespaces das coleções específicas de item. Este parâmetro corresponde ao de /imports opção de compilador vbc.exe. |
KeyContainer |
Parâmetro opcional de String . Especifica o nome do contêiner de chave de criptografia. Corresonds de esse parâmetro de /keycontainer a opção de compilador vbc.exe. |
KeyFile |
Parâmetro opcional de String . Especifica o nome de arquivo que contém a chave de criptografia. Para obter mais informações, consulte /keyfile. |
LangVersion |
Parâmetro opcional de [String] . Especifica a versão da linguagem, “9 " ou “10 ". |
LinkResources |
Parâmetro opcional de ITaskItem[] . Criar um link a um recurso do .NET Framework no arquivo de saída; o arquivo de recursos não é colocado no arquivo de saída. Este parâmetro corresponde ao de /linkresource opção de compilador vbc.exe. |
MainEntryPoint |
Parâmetro opcional de String . Especifica a classe ou módulo que contém o procedimento Sub Main. Corresonds de esse parâmetro de /main a opção de compilador vbc.exe. |
ModuleAssemblyName |
Parâmetro opcional de String . Especifica o assembly que este módulo é uma parte. |
NoConfig |
Parâmetro opcional de Boolean . Especifica que o compilador não deve usar o arquivo vbc.rsp. Este parâmetro corresponde ao parâmetro de /noconfig de compilador vbc.exe. |
NoLogo |
Parâmetro opcional de Boolean . Se true, suprime a exibição das informações de cabeçalho de compilador. Este parâmetro corresponde ao de /nologo opção de compilador vbc.exe. |
NoStandardLib |
Parâmetro opcional de Boolean . Faz com que o compilador não referencie as bibliotecas padrão. Este parâmetro corresponde ao de /nostdlib opção de compilador vbc.exe. |
NoVBRuntimeReference |
Parâmetro opcional de Boolean . Uso interno somente. Se verdadeiro, a referência automática a Microsoft.VisualBasic.dll. |
NoWarnings |
Parâmetro opcional de Boolean . Se true, a tarefa suprime todos os avisos. Para obter mais informações, consulte /nowarn. |
Optimize |
Parâmetro opcional de Boolean . Se true, ativar otimizações de compilador. Este parâmetro corresponde ao de /optimize opção de compilador vbc.exe. |
OptionCompare |
Parâmetro opcional de String . Especifica como são feitas comparações de cadeias de caracteres. Este parâmetro pode ter os seguintes valores:
O valor binary especifica que a tarefa usa comparações binárias de cadeias de caracteres. O valor text especifica que a tarefa usa comparações de cadeias de caracteres de texto. O valor padrão de esse parâmetro é binary. Este parâmetro corresponde ao de /optioncompare opção de compilador vbc.exe. |
OptionExplicit |
Parâmetro opcional de Boolean . Se truedeclaração explícita de variáveis, é necessário. Este parâmetro corresponde ao de /optionexplicit opção de compilador vbc.exe. |
OptionInfer |
Parâmetro opcional de Boolean . Se true, permite inferência de tipos de variáveis. |
OptionStrict |
Parâmetro opcional de Boolean . Se true, a tarefa aplica semânticas de tipo rígidas para restringir conversões implícitas de tipo. Este parâmetro corresponde ao de /optionstrict opção de compilador vbc.exe. |
OptionStrictType |
Parâmetro opcional de String . Especifica que a semântica de tipo rígidas gera um aviso. Atualmente, somente “custom” é suportado. Este parâmetro corresponde ao de /optionstrict opção de compilador vbc.exe. |
OutputAssembly |
Parâmetro de saída de String opcional. Especifica o nome do arquivo de saída. Este parâmetro corresponde ao de /out opção de compilador vbc.exe. |
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, de Itanium, ou de anycpu. O padrão é anycpu. Este parâmetro corresponde ao de /platform opção de compilador vbc.exe. |
References |
Parâmetro opcional de ITaskItem[] . Faz com que a tarefa importar informações pública do tipo dos itens especificados no projeto atual. Este parâmetro corresponde ao de /reference opção de compilador vbc.exe. |
RemoveIntegerChecks |
Parâmetro opcional de Boolean . Se true, verificações de erro de estouro de inteiros desativa. o valor padrão é false. Este parâmetro corresponde ao de /removeintchecks opção de compilador vbc.exe. |
Resources |
Parâmetro opcional de ITaskItem[] . Insere um recurso do .NET Framework no arquivo de saída. Este parâmetro corresponde ao de /resource opção de compilador vbc.exe. |
ResponseFiles |
Parâmetro opcional de ITaskItem[] . Especifica o arquivo de resposta que contém comandos para esta tarefa. Este parâmetro corresponde à opção de @ (especificar Arquivo de resposta) de compilador vbc.exe. |
RootNamespace |
Parâmetro opcional de String . Especifica o namespace raiz para todas as declarações de tipo. Este parâmetro corresponde ao de /rootnamespace opção de compilador vbc.exe. |
SdkPath |
Parâmetro opcional de String . Especifica o local mscorlib.dll e microsoft.visualbasic.dll. Este parâmetro corresponde ao de /sdkpath opção de compilador vbc.exe. |
Sources |
Parâmetro opcional de ITaskItem[] . Especifica um ou mais arquivos de origem de Visual Basic . |
TargetCompactFramework |
Parâmetro opcional de Boolean . Se true, a tarefa tem como alvo .NET Compact Framework. Este interruptor corresponde ao de /netcf opção de compilador vbc.exe. |
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 padrão é library. Este parâmetro corresponde ao de /target opção de compilador vbc.exe. |
Timeout |
Parâmetro opcional de Int32 . Especifica a quantidade de tempo, em milissegundos, depois do que o executável de tarefa é encerrado. O valor padrão é Int.MaxValue, indicando que não há nenhum intervalo de tempo limite. |
ToolPath |
Parâmetro opcional de String . Especifica o local de onde a tarefa carregará o arquivo executável subjacente (vbc.exe). Se este parâmetro não for especificado, a tarefa usa o caminho de instalação do SDK que corresponde à versão do framework que está executando MSBuild. |
TreatWarningsAsErrors |
Parâmetro opcional de Boolean . Se true, todos os avisos é tratado como erros. Para mais informações, consulte /warnaserror (Visual Basic). |
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. Este parâmetro corresponde ao de /utf8output opção de compilador vbc.exe. |
Verbosity |
Parâmetro opcional de String . Especifica a verbosidade de saída do compilador. A verbosidade pode ser Quiet, Normal (o padrão), ou Verbose. |
WarningsAsErrors |
Parâmetro opcional de String . Especifica uma lista de tratar avisos como erros. Para mais informações, consulte /warnaserror (Visual Basic). 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 (Visual Basic). 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. Este parâmetro corresponde ao de /win32icon opção de compilador vbc.exe. |
Win32Resources |
Parâmetro opcional de String . Insere um arquivo de recurso Win32 (.res) no arquivo de saída. Este parâmetro corresponde ao de /win32resource opção de compilador vbc.exe. |
Comentários
Além dos parâmetros listados acima, esta tarefa parâmetros 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 seguinte exemplo cria um projeto de Visual Basic .
<VBC
Sources="@(sources)"
Resources="strings.resources"
Optimize="true"
OutputAssembly="out.exe"/>