Compartilhar via


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