tarefa Vbc

Encapsula o vbc.exe, que produz executáveis (.exe), bibliotecas de vínculo dinâmico (.dll) ou módulos de código (.netmodule). Para obter mais informações sobre vbc.exe, confira Compilador de linha de comando do Visual Basic.

Parâmetros

A tabela a seguir descreve os parâmetros da tarefa Vbc.

Parâmetro	Descrição
AdditionalLibPaths	Parâmetro String[] opcional. Especifica as pastas adicionais nas quais procurar por assemblies especificados no atributo References.
AddModules	Parâmetro String[] opcional. Faz com que o compilador verifique todos os tipos de informações de arquivos especificados disponíveis para o projeto que você está compilando. Esse parâmetro corresponde à opção -addmodule do compilador vbc.exe.
BaseAddress	Parâmetro String opcional. Especifica o endereço básico do DLL. Esse parâmetro corresponde à opção -baseaddress do compilador vbc.exe.
CodePage	Parâmetro Int32 opcional. Especifica a página de código a ser usada para todos os arquivos de código-fonte na compilação. Esse parâmetro corresponde à opção -codepage do compilador vbc.exe.
DebugType	Parâmetro String[] opcional. Faz com que o compilador gere informações de depuração. Esse parâmetro pode ter os seguintes valores: - full - pdbonly O valor padrão é full, que permite 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 exibe o código de linguagem assembly somente quando o programa em execução está anexado ao depurador. Para saber mais, confira -debug (Visual Basic).
DefineConstants	Parâmetro String[] opcional. Define as constantes de compilador condicional. Os pares de símbolo/valor são separados por ponto e vírgula e são especificados usando a sintaxe a seguir: símbolo1 = valor1 ; símbolo2 = valor2 Esse parâmetro corresponde à opção -define do compilador vbc.exe.
DelaySign	Parâmetro Boolean opcional. Se true, a tarefa colocará a chave pública no assembly. Se false, a tarefa assina totalmente o assembly. O valor padrão é false. Esse parâmetro não tem nenhum efeito a menos que usado com o parâmetro KeyFile ou KeyContainer. Esse parâmetro corresponde à opção -delaysign do compilador vbc.exe.
Deterministic	Parâmetro Boolean opcional. Se ele for true, fará com que o compilador gere um assembly cujo conteúdo binário é idêntico entre compilações caso as entradas sejam idênticas. Para obter mais informações, confira -deterministic.
DisabledWarnings	Parâmetro String opcional. Suprime os avisos especificados. Você só precisa especificar a parte numérica do identificador de aviso. Vários avisos são separados por ponto e vírgula. Esse parâmetro corresponde à opção -nowarn do compilador vbc.exe.
DocumentationFile	Parâmetro String opcional. Processa os comentários de documentação para o arquivo XML especificado. Esse parâmetro substitui o atributo GenerateDocumentation. Para obter mais informações, confira -doc.
EmitDebugInformation	Parâmetro Boolean opcional. Se true, a tarefa gerará informações de depuração e as colocará em um arquivo .pdb. Para saber mais, confira -debug (Visual Basic).
ErrorReport	Parâmetro String opcional. Especifica como a tarefa deve relatar erros do compilador interno. Esse parâmetro pode ter os seguintes valores: - prompt - send - none Se prompt estiver especificado e ocorrer um erro interno do compilador, será exibida uma opção ao usuário para enviar os dados de erros à Microsoft. Se send for especificado e ocorrer um erro interno do compilador, a tarefa enviará os dados de erros à Microsoft. O valor padrão é none, que reporta os erros somente na saída de texto. Esse parâmetro corresponde à opção -errorreport do compilador vbc.exe.
FileAlignment	Parâmetro Int32 opcional. Especifica, em bytes, onde alinhar as seções do arquivo de saída. Esse parâmetro pode ter os seguintes valores: - 512 - 1024 - 2048 - 4096 - 8192 Esse parâmetro corresponde à opção -filealign do compilador vbc.exe.
GenerateDocumentation	Parâmetro Boolean opcional. Se true, serão geradas informações sobre a documentação, que serão colocadas em um arquivo XML com o nome do arquivo executável ou da biblioteca que a tarefa está criando. Para obter mais informações, confira -doc.
Imports	Parâmetro opcional ITaskItem[]. Importa namespaces de coleções do item especificado. Esse parâmetro corresponde à opção -imports do compilador vbc.exe.
KeyContainer	Parâmetro String opcional. Especifica o nome do contêiner da chave de criptografia. Esse parâmetro corresponde à opção -keycontainer do compilador vbc.exe.
KeyFile	Parâmetro String opcional. Especifica o nome de arquivo que contém a chave de criptografia. Para obter mais informações, confira -keyfile.
LangVersion	Parâmetro System.String opcional. Especifica a versão da linguagem, como "15.5".
LinkResources	Parâmetro opcional ITaskItem[]. Cria um link para um recurso do .NET Framework no arquivo de saída; o arquivo de recurso não é colocado no arquivo de saída. Esse parâmetro corresponde à opção -linkresource do compilador vbc.exe.
MainEntryPoint	Parâmetro String opcional. Especifica a classe ou o módulo que contém o procedimento Sub Main. Esse parâmetro corresponde à opção -main do compilador vbc.exe.
ModuleAssemblyName	Parâmetro String opcional. Especifica o assembly do qual esse módulo faz parte.
NoConfig	Parâmetro Boolean opcional. Especifica que o compilador não deve usar o arquivo vbc.rsp. Esse parâmetro corresponde ao parâmetro -noconfig do compilador vbc.exe.
NoLogo	Parâmetro Boolean opcional. Se for true, suprimirá a exibição de informações da barra de notificação do compilador. Esse parâmetro corresponde à opção -nologo do compilador vbc.exe.
NoStandardLib	Parâmetro Boolean opcional. Faz com que o compilador não referencie as bibliotecas padrão. Esse parâmetro corresponde à opção -nostdlib do compilador vbc.exe.
NoVBRuntimeReference	Parâmetro Boolean opcional. Somente para uso interno. Se verdadeiro, impede a referência automática para Microsoft.VisualBasic.dll.
NoWarnings	Parâmetro Boolean opcional. Se ele for true, a tarefa suprimirá todos os avisos. Para obter mais informações, confira -nowarn.
Optimize	Parâmetro Boolean opcional. Se true, habilita as otimizações do compilador. Esse parâmetro corresponde à opção -optimize do compilador vbc.exe.
OptionCompare	Parâmetro String opcional. Especifica como são feitas comparações de cadeia de caracteres. Esse parâmetro pode ter os seguintes valores: - binary - text O valor binary especifica que a tarefa usa comparações de cadeia de caracteres binária. O valor text especifica que a tarefa usa comparações de cadeia de caracteres de texto. O valor padrão desse parâmetro é binary. Esse parâmetro corresponde à opção -optioncompare do compilador vbc.exe.
OptionExplicit	Parâmetro Boolean opcional. Se true, a declaração explícita de variáveis é necessária. Esse parâmetro corresponde à opção -optionexplicit do compilador vbc.exe.
OptionInfer	Parâmetro Boolean opcional. Se true, permite a inferência de tipos de variáveis.
OptionStrict	Parâmetro Boolean opcional. Se true, a tarefa impõe semântica de tipo estrito para restringir conversões de tipo implícito. Esse parâmetro corresponde à opção -optionstrict do compilador vbc.exe.
OptionStrictType	Parâmetro String opcional. Especifica qual semântica de tipo estrito gera um aviso. Atualmente, há suporte para apenas "custom". Esse parâmetro corresponde à opção -optionstrict do compilador vbc.exe.
OutputAssembly	Parâmetro de saída String opcional. Especifica o nome do arquivo de saída. Esse parâmetro corresponde à opção -out do compilador vbc.exe.
Platform	Parâmetro String opcional. Especifica a plataforma do processador a ser direcionada pelo arquivo de saída. Esse parâmetro pode ter um valor igual a x86, x64Itanium ou anycpu. O padrão é anycpu. Esse parâmetro corresponde à opção -platform do compilador vbc.exe.
References	Parâmetro opcional ITaskItem[]. Faz com que a tarefa importe informações de tipo público dos itens especificados para o projeto atual. Esse parâmetro corresponde à opção -reference do compilador vbc.exe.
RemoveIntegerChecks	Parâmetro Boolean opcional. Se true, desabilita a verificação de erro de estouro de inteiro. O valor padrão é false. Esse parâmetro corresponde à opção -removeintchecks do compilador vbc.exe.
Resources	Parâmetro opcional ITaskItem[]. Insere um recurso do .NET Framework no arquivo de saída. Esse parâmetro corresponde à opção -resource do compilador vbc.exe.
ResponseFiles	Parâmetro opcional ITaskItem[]. Especifica o arquivo de resposta que contém comandos para essa tarefa. Esse parâmetro corresponde à opção @ (Especificar Arquivo de Resposta) do compilador vbc.exe.
RootNamespace	Parâmetro String opcional. Especifica o namespace raiz para todas as declarações de tipo. Esse parâmetro corresponde à opção -rootnamespace do compilador vbc.exe.
SdkPath	Parâmetro String opcional. Especifica o local de mscorlib.dll e microsoft.visualbasic.dll. Esse parâmetro corresponde à opção -sdkpath do compilador vbc.exe.
Sources	Parâmetro opcional ITaskItem[]. Especifica um ou mais arquivos de origem do Visual Basic.
TargetCompactFramework	Parâmetro Boolean opcional. Se true, a tarefa será direcionada ao .NET Compact Framework. Essa opção corresponde à opção -netcf do compilador vbc.exe.
TargetType	Parâmetro String opcional. Especifica o formato do arquivo de saída. Esse parâmetro pode ter um valor igual a 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. Esse parâmetro corresponde à opção -target do compilador vbc.exe.
Timeout	Parâmetro Int32 opcional. Especifica a quantidade de tempo em milissegundos após o qual o executável da tarefa é encerrado. O valor padrão é Int.MaxValue, indicando que não há período de tempo limite.
ToolPath	Parâmetro String opcional. Especifica o local do qual a tarefa carregará o arquivo executável subjacente (vbc.exe). Se esse parâmetro não for especificado, a tarefa usará o caminho de instalação do SDK correspondente à versão da estrutura que está executando o MSBuild.
TreatWarningsAsErrors	Parâmetro Boolean opcional. Se true, todos os avisos são tratados como erros. Para obter mais informações, confira -warnaserror (Visual Basic).
UseHostCompilerIfAvailable	Parâmetro Boolean opcional. Instrui a tarefa a usar o objeto do compilador em processo, se disponível. Usado somente pelo Visual Studio.
Utf8Output	Parâmetro Boolean opcional. Registra a saída do compilador usando a codificação UTF-8. Esse parâmetro corresponde à opção -utf8output do compilador vbc.exe.
Verbosity	Parâmetro String opcional. Especifica o nível de detalhes da saída do compilador. Os detalhes podem ser Quiet, Normal (o padrão) ou Verbose.
WarningsAsErrors	Parâmetro String opcional. Especifica uma lista de avisos a serem tratados como erros. Para obter mais informações, confira -warnaserror (Visual Basic). Esse parâmetro substitui o parâmetro TreatWarningsAsErrors.
WarningsNotAsErrors	Parâmetro String opcional. Especifica uma lista de avisos que não são tratados como erros. Para obter mais informações, confira -warnaserror (Visual Basic). Esse parâmetro será útil apenas se o parâmetro TreatWarningsAsErrors for definido como true.
Win32Icon	Parâmetro String opcional. Insere um arquivo .ico no assembly, que fornece ao arquivo de saída a aparência desejada no Explorador de Arquivos. Esse parâmetro corresponde à opção -win32icon do compilador vbc.exe.
Win32Resources	Parâmetro String opcional. Insere um arquivo (.res) do recurso do Win32 no arquivo de saída. Esse parâmetro corresponde à opção -win32resource do compilador vbc.exe.

Parâmetros ToolTaskExtension

Essa tarefa herda da classe ToolTaskExtension, que herda da classe ToolTask, que por sua vez herda da classe Task. Esta cadeia de herança adiciona vários parâmetros nas tarefas que derivam deles.

A seguinte tabela descreve os parâmetros das classes base:

Parâmetro	Descrição
EchoOff	Parâmetro bool opcional. Quando definido como true, essa tarefa passa /Q para a linha de comando de cmd.exe, de modo que a linha de comando não é copiada para stdout.
EnvironmentVariables	Parâmetro de matriz String opcional. Matriz de definições da variável de ambiente, separadas por ponto e vírgula. Cada definição deve especificar um nome da variável de ambiente e um valor separados por um sinal de igual. Essas variáveis são passadas para o executável gerado além, ou seletivamente substituindo, o bloco de ambiente regular. Por exemplo, Variable1=Value1;Variable2=Value2.
ExitCode	Parâmetro de saída opcional somente leitura Int32. Especifica o código de saída fornecido pelo comando executado. Se a tarefa registra erros, mas o processo tem um código de saída de 0 (êxito), isso é definido como -1.
LogStandardErrorAsError	Parâmetro bool opcional. Se true, todas as mensagens recebidas no fluxo de erro padrão são registradas como erros.
StandardErrorImportance	Parâmetro String opcional. a importância com a qual o texto do fluxo de erro padrão deve ser registrado.
StandardOutputImportance	Parâmetro String opcional. Importância para fazer o texto de log do fluxo de saída do padrão.
Timeout	Parâmetro Int32 opcional. Especifica a quantidade de tempo em milissegundos após o qual o executável da tarefa é encerrado. O valor padrão é Int.MaxValue, indicando que não há período de tempo limite. O tempo limite está em milissegundos.
ToolExe	Parâmetro string opcional. Projetos podem implementar para substituir um ToolName. Tarefas podem substituir isso para preservar o ToolName.
ToolPath	Parâmetro string opcional. Especifica o local de onde a tarefa carrega o arquivo executável subjacente. Se esse parâmetro não for especificado, a tarefa usará o caminho de instalação do SDK correspondente à versão da estrutura que está executando o MSBuild.
UseCommandProcessor	Parâmetro bool opcional. Quando definido como true, essa tarefa cria um arquivo em lotes para a linha de comando e o executa usando o processador de comando em vez de executar o comando diretamente.
YieldDuringToolExecution	Parâmetro bool opcional. Quando definido como true, essa tarefa gera o nó quando a tarefa está em execução.

Exemplo

O exemplo a seguir compila um projeto do Visual Basic.

<VBC
   Sources="@(sources)"
   Resources="strings.resources"
   Optimize="true"
   OutputAssembly="out.exe"/>

Confira também

• Compilador de linha de comando do Visual Basic
• Tarefas
• Referência de tarefas