Vbc (tarea)

  • Artículo

Incluye vbc.exe, que genera ejecutables ( .exe), archivos de biblioteca de vínculos dinámicos ( .dll) o módulos de código ( .netmodule). Para obtener más información sobrevbc.exe, vea Compilador de línea de comandos 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 buscar ensamblados especificados en el atributo References.
AddModules Parámetro String[] opcional.

Hace que el compilador facilite al proyecto que se está compilando toda la información de tipos presente en los archivos especificados. 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 se va a usar para todos los archivos de código fuente de 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 asociar un depurador al programa en ejecución. Un valor de pdbonly permite la depuración de código fuente cuando el programa se inicia en el depurador, pero muestra código de lenguaje ensamblador solo cuando el programa en ejecución 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 completamente el ensamblado. El valor predeterminado es false. Este parámetro no tiene ningún efecto a no ser que se use con el parámetro KeyFile o el parámetro KeyContainer. Este parámetro corresponde al modificador -delaysign del compilador de vbc.exe.
Deterministic Parámetro Boolean opcional.

Si es true, hace que el compilador genere un ensamblado cuyo contenido binario es idéntico en todas las compilaciones si las entradas son idénticas.

Para obtener más información, vea -deterministic.
DisabledWarnings Parámetro String opcional.

Suprime las advertencias especificadas. Solo necesita especificar la parte numérica del identificador de advertencia. Las advertencias múltiples se separan 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 invalida 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 debe documentar la tarea los errores internos del compilador. Este parámetro puede tener los valores siguientes:

- prompt
- send
- none

Si prompt está especificado y se produce un error del compilador interno, le aparece una opción al usuario sobre si enviar los datos de error a Microsoft.

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

El valor predeterminado es none, que notifica errores solo en la salida de texto.

Este parámetro corresponde al modificador -errorreport del compilador de vbc.exe.
FileAlignment Parámetro Int32 opcional.

Especifica, en bytes, dónde se alinean las secciones del archivo de salida. 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 la biblioteca que está creando la tarea. Para obtener más información, vea -doc.
Imports Parámetro ITaskItem[] opcional.

Importa 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.
LangVersion Parámetro System.String opcional.

Especifica la versión del lenguaje, como "15.5".
LinkResources Parámetro ITaskItem[] opcional.

Crea un vínculo a un recurso de .NET Framework en el archivo de salida; el archivo de recursos no se coloca en el archivo de salida. Este parámetro corresponde al modificador -linkresource del compilador de vbc.exe.
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.
ModuleAssemblyName Parámetro String opcional.

Especifica el ensamblado del que este módulo forma parte.
NoConfig Parámetro Boolean opcional.

Especifica que el compilador no debe usar el archivo vbc.rsp. Este parámetro corresponde al parámetro -noconfig del compilador de vbc.exe.
NoLogo Parámetro Boolean opcional.

Si true, suprime la visualización de la información de encabezado 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.
NoVBRuntimeReference Parámetro Boolean opcional.

Solo para uso interno. Si es True, evita la referencia automática en Microsoft.VisualBasic.dll.
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, permite las optimizaciones del compilador. Este parámetro corresponde al modificador -optimize del compilador de vbc.exe.
OptionCompare Parámetro String opcional.

Especifica la forma en que se realizan las comparaciones de cadenas. Este parámetro puede tener los valores siguientes:

- binary
- text

El valor binary especifica que la tarea usa comparaciones de cadenas binarias. El valor text especifica que la tarea usa 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 requiere la declaración explícita de variables. Este parámetro corresponde al modificador -optionexplicit del compilador de vbc.exe.
OptionInfer Parámetro Boolean opcional.

Si es true, permite la inferencia de tipos de variables.
OptionStrict Parámetro Boolean opcional.

Si es true, la tarea exige la semántica estricta de tipos para restringir las conversiones implícitas de tipos. Este parámetro corresponde al modificador -optionstrict del compilador de vbc.exe.
OptionStrictType Parámetro String opcional.

Especifica qué semántica estricta de tipos genera una advertencia. Actualmente, solo se admite "custom". 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 salida. Este parámetro corresponde al modificador -out del compilador de vbc.exe.
Platform Parámetro String opcional.

Especifica la plataforma del procesador que debe destinar el archivo de salida. 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 información de tipo pública de los elementos especificados en el 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 de 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.
ResponseFiles Parámetro ITaskItem[] opcional.

Especifica el archivo de respuesta que contiene 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 de la 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 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 salida. Este parámetro puede tener un valor de library, que crea una biblioteca de código, 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 después del cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue, que indica que no hay período de 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 usa la ruta de instalación del SDK que se corresponde con la versión de la plataforma 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. Usado solamente 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 nivel de detalle de los resultados del compilador. El nivel de detalle puede ser Quiet, Normal (el 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 invalida 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 solo es útil si el parámetro TreatWarningsAsErrors está establecido en true.
Win32Icon Parámetro String opcional.

Inserta un archivo .ico en el ensamblado, lo que proporciona al archivo de salida la apariencia deseada en el Explorador de archivos. 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 salida. Este parámetro corresponde al modificador -win32resource del compilador de vbc.exe.

Parámetros de ToolTaskExtension

Esta tarea hereda de la clase ToolTaskExtension, que hereda de la clase ToolTask, la cual, a su vez, hereda de la clase Task. Esta cadena de herencia agrega varios parámetros a las tareas que derivan de ellos.

En la siguiente tabla se describen los parámetros de las clases base:

Parámetro Descripción
EchoOff Parámetro bool opcional.

Cuando se establece en true, esta tarea pasa /Q a la línea de comandos cmd.exe de modo que la línea de comandos no se copia en stdout.
EnvironmentVariables Parámetro de matriz String opcional.

Matriz de definiciones de variables de entorno, separadas por punto y coma. Cada definición debe especificar un valor y un nombre para la variable de entorno separados por un signo igual. Estas variables se pasan al ejecutable generado y, además, pasan el bloque de entorno normal o lo invalidan de manera selectiva. Por ejemplo, Variable1=Value1;Variable2=Value2.
ExitCode Parámetro de solo lectura de salida Int32 opcional.

Especifica el código de salida proporcionado por el comando ejecutado. Si la tarea registró errores pero el proceso tenía un código de salida de 0 (correcto), se establece en -1.
LogStandardErrorAsError Parámetro bool opcional.

Si true, todos los mensajes recibidos en el flujo de error estándar se registran como errores.
StandardErrorImportance Parámetro String opcional.

Importancia con la que se va a registrar el texto de la secuencia de error estándar.
StandardOutputImportance Parámetro String opcional.

Importancia con la que se va a registrar el texto de la secuencia de salida estándar.
Timeout Parámetro Int32 opcional.

Especifica el tiempo en milisegundos después del cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue, que indica que no hay período de tiempo de espera. Tiempo de espera en milisegundos.
ToolExe Parámetro string opcional.

Los proyectos pueden implementarlo para invalidar ToolName. Las tareas pueden invalidarlo para conservar ToolName.
ToolPath Parámetro string opcional.

Especifica la ubicación desde donde la tarea carga el archivo ejecutable subyacente. Si no se especifica este parámetro, la tarea usa la ruta de instalación del SDK que se corresponde con la versión del marco de trabajo que está ejecutando MSBuild.
UseCommandProcessor Parámetro bool opcional.

Cuando se establece en true, esta tarea crea un archivo por lotes para la línea de comandos y lo ejecuta mediante el procesador de comandos, en lugar de ejecutar el comando directamente.
YieldDuringToolExecution Parámetro bool opcional.

Cuando se establece en true, esta tarea produce el nodo cuando se ejecuta la tarea.

Ejemplo

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

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

Vea también