Tarefa de Vbc
Disposição Vbc. exe, que produz arquivos 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, consulte Compilador do Visual Basic.
Parâmetros
A tabela a seguir descreve os parâmetros da Vbc de tarefas.
Parâmetro |
Descrição |
|---|---|
AdditionalLibPaths |
Opcional String[] parâmetro. Especifica as pastas adicionais no qual procurar conjuntos de módulos especificados no atributo referências. |
AddModules |
Opcional String[] parâmetro. Faz o compilador tornar todos os digite as informações dos arquivos especificados disponíveis para o projeto que você está compilando no momento. Este parâmetro corresponde do /addmodule opção do compilador Vbc. exe. |
BaseAddress |
Opcional String parâmetro. Especifica o endereço base da DLL. Este parâmetro corresponde do /baseaddress opção do compilador Vbc. exe. |
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. Este parâmetro corresponde do /codepage opção do compilador Vbc. exe. |
DebugType |
Opcional String[] parâmetro. 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 anexar um depurador para o programa em execução. Um valor de pdbonly permite que o código-fonte, depuração 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 obter mais informações, consulte /debug (Visual Basic). |
DefineConstants |
Opcional String[] parâmetro. Define constantes de compilador condicional. Símbolo/valor pares são separados por ponto e vírgula e são especificados com a seguinte sintaxe: symbol1=valor1;símbolo2=valor2 Este parâmetro corresponde do /define opção do compilador Vbc. exe. |
DelaySign |
Opcional Boolean parâmetro. Se true, a tarefa coloca a chave pública do assembly. Se false, a tarefa totalmente assina o assembly. O valor padrão é false.Este parâmetro não tem efeito a menos que usado com o KeyFile parâmetro ou o KeyContainer parâmetro. Este parâmetro corresponde do /delaysign opção do compilador Vbc. exe. |
DisabledWarnings |
Opcional String parâmetro. Suprime os avisos especificados. Você só precisará especificar a parte numérica do identificador de aviso. Vários avisos são separados por ponto e vírgula. Este parâmetro corresponde do /nowarn opção do compilador Vbc. exe. |
DocumentationFile |
Opcional String parâmetro. Processa os comentários de documentação para o arquivo XML especificado. Esse parâmetro substitui a GenerateDocumentation atributo. Para obter mais informações, consulte /doc. |
EmitDebugInformation |
Opcional Boolean parâmetro. Se true, a tarefa gera informações de depuração e o coloca em um arquivo. PDB. Para obter mais informações, consulte /debug (Visual Basic). |
ErrorReport |
Opcional String parâmetro. Especifica como a tarefa deve relatar erros do compilador interno. Este parâmetro pode ter os seguintes valores:
Se prompt for especificado e ocorrerá um erro interno do compilador, o usuário é solicitado com uma opção de se enviar os dados de erro à Microsoft. Se send for especificado e ocorrerá um erro interno do compilador, a tarefa envia os dados de erro à Microsoft. O valor padrão é none, os relatórios de erros no texto de saída apenas. Este parâmetro corresponde do /errorreport opção do compilador Vbc. exe. |
FileAlignment |
Opcional Int32 parâmetro. 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 do /filealign opção do compilador Vbc. exe. |
GenerateDocumentation |
Opcional Boolean parâmetro. Se true, gera informações de documentação e o coloca 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 |
Opcional ITaskItem[] parâmetro. Importa namespaces das coleções item especificado. Este parâmetro corresponde do /Imports opção do compilador Vbc. exe. |
KeyContainer |
Opcional String parâmetro. Especifica o nome do recipiente de chave de criptografia. Este corresonds de parâmetro para o /keycontainer opção do compilador Vbc. exe. |
KeyFile |
Opcional String parâmetro. Especifica o nome do arquivo que contém a chave criptográfica. Para obter mais informações, consulte /keyfile. |
LangVersion |
Opcional [String] parâmetro. Especifica a versão de idioma, "9" ou "10". |
LinkResources |
Opcional ITaskItem[] parâmetro. Cria um link para um.Recurso NET Framework no arquivo de saída; o arquivo de recurso não é colocado no arquivo de saída. Este parâmetro corresponde do /linkresource opção do compilador Vbc. exe. |
MainEntryPoint |
Opcional String parâmetro. Especifica a classe ou módulo que contém o procedimento Sub Main. Este corresonds de parâmetro para o /principal opção do compilador Vbc. exe. |
ModuleAssemblyName |
Opcional String parâmetro. Especifica o assembly que este módulo é uma parte. |
NoConfig |
Opcional Boolean parâmetro. Especifica que o compilador não deve usar o arquivo Vbc. Este parâmetro corresponde do /noconfig parâmetro do compilador Vbc. exe. |
NoLogo |
Opcional Boolean parâmetro. Se true, suprime a exibição de informações de faixa do compilador. Este parâmetro corresponde do /nologo opção do compilador Vbc. exe. |
NoStandardLib |
Opcional Boolean parâmetro. Faz com que o compilador não referenciar as bibliotecas padrões. Este parâmetro corresponde do /nostdlib opção do compilador Vbc. exe. |
NoVBRuntimeReference |
Opcional Boolean parâmetro. Somente para uso interno. Se verdadeiro, impede que a referência automática Microsoft.VisualBasic.dll.. |
NoWarnings |
Opcional Boolean parâmetro. Se true, suprime a tarefa todos os avisos. Para obter mais informações, consulte /nowarn. |
Optimize |
Opcional Boolean parâmetro. Se true, permite otimizações do compilador. Este parâmetro corresponde do /Optimize opção do compilador Vbc. exe. |
OptionCompare |
Opcional String parâmetro. 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 de seqüência de caracteres binária. O valor text Especifica que a tarefa usa comparações de seqüência de caracteres de texto. O valor padrão deste parâmetro é binary. Este parâmetro corresponde do /optioncompare opção do compilador Vbc. exe. |
OptionExplicit |
Opcional Boolean parâmetro. Se true, declaração explícita de variáveis é necessária. Este parâmetro corresponde do /optionexplicit opção do compilador Vbc. exe. |
OptionInfer |
Opcional Boolean parâmetro. Se true, que permite que a inferência de tipos de variáveis. |
OptionStrict |
Opcional Boolean parâmetro. Se true, a tarefa impõe semântica tipo estrito para restringir as conversões de tipo implícito. Este parâmetro corresponde do /optionstrict opção do compilador Vbc. exe. |
OptionStrictType |
Opcional String parâmetro. Especifica qual semântica tipo estrito gere um aviso. Atualmente, apenas "personalizado" é suportado. Este parâmetro corresponde do /optionstrict opção do compilador Vbc. exe. |
OutputAssembly |
Opcional String parâmetro de saída. Especifica o nome do arquivo de saída. Este parâmetro corresponde do /out opção do compilador Vbc. exe. |
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, Itanium, ou anycpu. O padrão é anycpu. Este parâmetro corresponde do /platform opção do compilador Vbc. exe. |
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. Este parâmetro corresponde do /reference opção do compilador Vbc. exe. |
RemoveIntegerChecks |
Opcional Boolean parâmetro. Se true, desativa o estouro de inteiro erro verificações. O valor padrão é false. Este parâmetro corresponde do /removeintchecks opção do compilador Vbc. exe. |
Resources |
Opcional ITaskItem[] parâmetro. Incorpora um.Recurso NET Framework no arquivo de saída. Este parâmetro corresponde do /resource opção do compilador Vbc. exe. |
ResponseFiles |
Opcional ITaskItem[] parâmetro. Especifica o arquivo de resposta que contém comandos para esta tarefa. Este parâmetro corresponde do @ (especificar o arquivo de resposta) opção do compilador Vbc. exe. |
RootNamespace |
Opcional String parâmetro. Especifica o namespace raiz para todas as declarações de tipo. Este parâmetro corresponde do /rootnamespace opção do compilador Vbc. exe. |
SdkPath |
Opcional String parâmetro. Especifica a localização do mscorlib. dll e microsoft.visualbasic.dll. Este parâmetro corresponde do /sdkpath opção do compilador Vbc. exe. |
Sources |
Opcional ITaskItem[] parâmetro. Especifica um ou mais Visual Basic arquivos de origem. |
TargetCompactFramework |
Opcional Boolean parâmetro. Se true, os destinos de tarefa do .NET Compact Framework. Esta opção corresponde do /netcf opção do compilador Vbc. exe. |
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 padrão é library. Este parâmetro corresponde do /target opção do compilador Vbc. exe. |
Timeout |
Opcional Int32 parâmetro. Especifica a quantidade de tempo, 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 tempo limite. |
ToolPath |
Opcional String parâmetro. Especifica o local de onde a tarefa será carregado 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 correspondentes à versão do framework que está executando o MSBuild. |
TreatWarningsAsErrors |
Opcional Boolean parâmetro. Se true, todos os avisos são tratados como erros. Para obter mais informações, consulte /warnaserror (Visual Basic). |
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. Este parâmetro corresponde do /utf8output opção do compilador Vbc. exe. |
Verbosity |
Opcional String parâmetro. Especifica a verbosidade de saída do compilador. Verbosidade pode ser Quiet, Normal (padrão), ou Verbose. |
WarningsAsErrors |
Opcional String parâmetro. Especifica uma lista de avisos para tratar como erros. Para obter mais informações, consulte /warnaserror (Visual Basic). 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 (Visual Basic). 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. Este parâmetro corresponde do /win32icon Alternar do compilador Vbc. exe. |
Win32Resources |
Opcional String parâmetro. Insere um arquivo de recurso (. res) do Win32 no arquivo de saída. Este parâmetro corresponde do /win32resource Alternar do compilador Vbc. exe. |
Comentários
Além de para os parâmetros listados acima, esta tarefa herda os parâmetros da 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 compila um Visual Basic project.
<VBC
Sources="@(sources)"
Resources="strings.resources"
Optimize="true"
OutputAssembly="out.exe"/>