Compartir a través de

Vbc (Tarea)

  • Artículo

Actualización: noviembre 2007

Contiene vbc.exe, que genera archivos ejecutables (.exe), bibliotecas de vínculos dinámicos (.dll) o módulos de código (.netmodule). Para obtener más información sobre vbc.exe, consulte Compilador de Visual Basic.

Parámetros

En la siguiente tabla se describen los parámetros de la tarea Vbc.

Parámetro

Descripción

AdditionalLibPaths

Parámetro String[] opcional.

Especifica carpetas adicionales en las que se han de buscar los ensamblados especificados en el atributo References.

AddModules

Parámetro String[] opcional.

Hace que el compilador facilite la información de tipos presente en los archivos especificados al proyecto que se compila actualmente. Este parámetro corresponde al modificador /addmodule del compilador de vbc.exe.

BaseAddress

Parámetro String opcional.

Especifica la dirección base del archivo DLL. Este parámetro corresponde al modificador /baseaddress del compilador de vbc.exe.

CodePage

Parámetro Int32 opcional.

Especifica la página de códigos que debe utilizarse para todos los archivos de código fuente en la compilación. Este parámetro corresponde al modificador /codepage del compilador de vbc.exe.

DebugType

Parámetro String[] opcional.

Hace que el compilador genere información de depuración. Este parámetro puede tener los valores siguientes:

  • full

  • pdbonly

El valor predeterminado es full, que permite adjuntar un depurador al programa en ejecución. Un valor de pdbonly permite depurar el código fuente cuando el programa se inicializa en el depurador, pero sólo mostrará el código de lenguaje de ensamblado cuando el programa que se ejecuta está asociado al depurador. Para obtener más información, vea /debug (Visual Basic).

DefineConstants

Parámetro String[] opcional.

Permite definir constantes condicionales para el compilador. Los pares símbolo/valor van separados por punto y coma y se especifican con la siguiente sintaxis:

symbol1=value1;symbol2=value2

Este parámetro corresponde al modificador /define del compilador de vbc.exe.

DelaySign

Parámetro Boolean opcional.

Si es true, la tarea coloca la clave pública en el ensamblado. Si es false, la tarea firma totalmente el ensamblado. El valor predeterminado es false. Este parámetro no tiene ningún efecto a menos que se utilice con el parámetro KeyFile o el parámetro KeyContainer. Este parámetro corresponde al modificador /delaysign del compilador de vbc.exe.

DisabledWarnings

Parámetro String opcional.

Suprime las advertencias especificadas. Sólo hay que especificar la parte numérica del identificador de advertencia. Las advertencias múltiples están separadas con punto y coma. Este parámetro corresponde al modificador /nowarn del compilador de vbc.exe.

DocumentationFile

Parámetro String opcional.

Procesa los comentarios de documentación en el archivo XML especificado. Este parámetro reemplaza el atributo GenerateDocumentation. Para obtener más información, vea /doc.

EmitDebugInformation

Parámetro Boolean opcional.

Si es true, la tarea genera información de depuración y la coloca en un archivo .pdb. Para obtener más información, vea /debug (Visual Basic).

ErrorReport

Parámetro String opcional.

Especifica cómo la tarea debería documentar los errores internos del compilador. Este parámetro puede tener los valores siguientes:

  • prompt

  • send

  • none

Si se especifica prompt y se produce un error interno del compilador, se mostrará un mensaje al usuario con la opción de enviar los datos de error a Microsoft.

Si se especifica send y se produce un error interno del compilador, la tarea envía los datos de error a Microsoft.

El valor predeterminado es none, que sólo muestra los errores en formato texto.

Este parámetro corresponde al modificador /errorreport del compilador de vbc.exe.

FileAlignment

Parámetro Int32 opcional.

Especifica, en bytes, dónde alinear las secciones del archivo de resultados. Este parámetro puede tener los valores siguientes:

  • 512

  • 1024

  • 2048

  • 4096

  • 8192

Este parámetro corresponde al modificador /filealign del compilador de vbc.exe.

GenerateDocumentation

Parámetro Boolean opcional.

Si es true, genera información de documentación y la coloca en un archivo XML con el nombre del archivo ejecutable o biblioteca que está creando la tarea. Para obtener más información, vea /doc.

Imports

Parámetro ITaskItem[] opcional.

Importa los espacios de nombres de las colecciones de elementos especificadas. Este parámetro corresponde al modificador /imports del compilador de vbc.exe.

KeyContainer

Parámetro String opcional.

Especifica el nombre del contenedor de claves criptográficas. Este parámetro corresponde al modificador /keycontainer del compilador de vbc.exe.

KeyFile

Parámetro String opcional.

Especifica el nombre de archivo que contiene la clave criptográfica. Para obtener más información, vea /keyfile.

LinkResources

Parámetro ITaskItem[] opcional.

Crea un vínculo con un archivo de recursos de .NET Framework en el archivo de resultados, pero el archivo de recursos no se coloca en el archivo de resultados. Este parámetro corresponde al modificador /linkresource del compilador de vbc.exe.

Los elementos que se pasan a este parámetro pueden tener entradas opcionales de metadatos denominadas LogicalName y Access. LogicalName corresponde al argumento identifier del modificador /linkresource, y Access corresponde al argumento filename.

MainEntryPoint

Parámetro String opcional.

Especifica la clase o el módulo que contiene el procedimiento Sub Main. Este parámetro corresponde al modificador /main del compilador de vbc.exe.

NoConfig

Parámetro Boolean opcional.

Especifica que el compilador no debería utilizar el archivo vbc.rsp. Este parámetro corresponde al modificador /noconfig del compilador de vbc.exe.

NoLogo

Parámetro Boolean opcional.

Si es true, suprime la presentación de información de titular del compilador. Este parámetro corresponde al modificador /nologo del compilador de vbc.exe.

NoStandardLib

Parámetro Boolean opcional.

Hace que el compilador no haga referencia a las bibliotecas estándar. Este parámetro corresponde al modificador /nostdlib del compilador de vbc.exe.

NoWarnings

Parámetro Boolean opcional.

Si es true, la tarea suprime todas las advertencias. Para obtener más información, vea /nowarn.

Optimize

Parámetro Boolean opcional.

Si es true, habilita las optimizaciones del compilador. Este parámetro corresponde al modificador /optimize del compilador de vbc.exe.

OptionCompare

Parámetro String opcional.

Especifica la forma de realizar las comparaciones de cadenas. Este parámetro puede tener los valores siguientes:

  • binary

  • text

El valor binary especifica que la tarea utiliza las comparaciones de cadenas binarias. El valor text especifica que la tarea utiliza las comparaciones de cadenas de texto. El valor predeterminado de este parámetro es binary. Este parámetro corresponde al modificador /optioncompare del compilador de vbc.exe.

OptionExplicit

Parámetro Boolean opcional.

Si es true, se necesita la declaración explícita de variables. Este parámetro corresponde al modificador /optionexplicit del compilador de vbc.exe.

OptionStrict

Parámetro Boolean opcional.

Si es true, la tarea fuerza la semántica de tipos estricta para que restrinja las conversiones de tipos implícitas. Este parámetro corresponde al modificador /optionstrict del compilador de vbc.exe.

OutputAssembly

Parámetro de salida String opcional.

Especifica el nombre del archivo de resultados. Este parámetro corresponde al modificador /out del compilador de vbc.exe.

Platform

Parámetro String opcional.

Especifica la plataforma del procesador de destino del archivo de resultados. Este parámetro puede tener un valor de x86, x64, Itanium o anycpu. El valor predeterminado es anycpu. Este parámetro corresponde al modificador /platform del compilador de vbc.exe.

References

Parámetro ITaskItem[] opcional.

Hace que la tarea importe la información de tipo pública de los elementos especificados al proyecto actual. Este parámetro corresponde al modificador /reference del compilador de vbc.exe.

RemoveIntegerChecks

Parámetro Boolean opcional.

Si es true, deshabilita las comprobaciones de errores del desbordamiento de enteros. El valor predeterminado es false. Este parámetro corresponde al modificador /removeintchecks del compilador de vbc.exe.

Resources

Parámetro ITaskItem[] opcional.

Incrusta un recurso de .NET Framework en el archivo de salida. Este parámetro corresponde al modificador /resource del compilador de vbc.exe.

Los elementos que se pasan a este parámetro pueden tener entradas opcionales de metadatos denominadas LogicalName y Access. LogicalName corresponde al parámetro identifier del modificador /resource, y Access corresponde al parámetro filename.

ResponseFiles

Parámetro ITaskItem[] opcional.

Especifica el archivo de respuesta que contiene los comandos para esta tarea. Este parámetro corresponde a la opción @ (especificar archivo de respuesta) del compilador de vbc.exe.

RootNamespace

Parámetro String opcional.

Especifica el espacio de nombres raíz para todas las declaraciones de tipos. Este parámetro corresponde al modificador /rootnamespace del compilador de vbc.exe.

SdkPath

Parámetro String opcional.

Especifica la ubicación de mscorlib.dll y microsoft.visualbasic.dll. Este parámetro corresponde al modificador /sdkpath del compilador de vbc.exe.

Sources

Parámetro ITaskItem[] opcional.

Especifica uno o varios archivos de origen de Visual Basic.

TargetCompactFramework

Parámetro Boolean opcional.

Si es true, la tarea tiene como destino .NET Compact Framework. Este modificador corresponde al modificador /netcf del compilador de vbc.exe.

TargetType

Parámetro String opcional.

Especifica el formato del archivo de resultados. Este parámetro puede tener un valor de library, que crea una biblioteca de códigos, exe, que crea una aplicación de consola, module, que crea un módulo, o winexe, que crea un programa de Windows. El valor predeterminado es library. Este parámetro corresponde al modificador /target del compilador de vbc.exe.

Timeout

Parámetro Int32 opcional.

Especifica el tiempo, en milisegundos, tras el cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue; es decir, no existe tiempo de espera.

ToolPath

Parámetro String opcional.

Especifica la ubicación desde donde la tarea cargará el archivo ejecutable subyacente (vbc.exe). Si no se especifica este parámetro, la tarea utiliza la ruta de acceso de instalación de SDK correspondiente a la versión de Framework que está ejecutando MSBuild.

TreatWarningsAsErrors

Parámetro Boolean opcional.

Si es true, todas las advertencias se tratan como errores. Para obtener más información, vea /warnaserror (Visual Basic).

UseHostCompilerIfAvailable

Parámetro Boolean opcional.

Indica a la tarea que utilice el objeto de compilador en proceso, si está disponible. Utilizado únicamente por Visual Studio.

Utf8Output

Parámetro Boolean opcional.

Registra los resultados del compilador mediante la codificación UTF-8. Este parámetro corresponde al modificador /utf8output del compilador de vbc.exe.

Verbosity

Parámetro String opcional.

Especifica el contenido de los resultados del compilador. Los valores del contenido pueden ser Quiet, Normal (valor predeterminado), o Verbose.

WarningsAsErrors

Parámetro String opcional.

Especifica una lista de advertencias que se tratarán como errores. Para obtener más información, vea /warnaserror (Visual Basic).

Este parámetro reemplaza el parámetro TreatWarningsAsErrors.

WarningsNotAsErrors

Parámetro String opcional.

Especifica una lista de advertencias que no se tratarán como errores. Para obtener más información, vea /warnaserror (Visual Basic).

Este parámetro sólo resulta útil si el parámetro TreatWarningsAsErrors se establece en true.

Win32Icon

Parámetro String opcional.

Inserta un archivo .ico en el ensamblado, que da el aspecto deseado al archivo de resultados en el Explorador de Windows. Este parámetro corresponde al modificador /win32icon del compilador de vbc.exe.

Win32Resources

Parámetro String opcional.

Inserta un recurso de Win32 archivo (.res) en el archivo de resultados. Este parámetro corresponde al modificador /win32resource del compilador de vbc.exe.

Ejemplo

En el siguiente ejemplo se compila un proyecto de Visual Basic.

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

Vea también

Conceptos

Tareas de MSBuild

Otros recursos

Compilador de Visual Basic

Referencia de tareas de MSBuild