Opciones del compilador de Visual Basic, por categoría

  • Artículo

El compilador de línea de comandos de Visual Basic se ofrece como alternativa a la compilación de programas desde el entorno de desarrollo integrado (IDE) de Visual Studio. La siguiente es una lista de las opciones de línea de comandos del compilador de Visual Basic clasificadas por categoría funcional.

Cada opción del compilador está disponible en dos formatos: -option y /option . En la documentación solo se muestra el formato -option.

Salida del compilador

Opción Propósito
-nologo Suprime la información de titular del compilador.
-utf8output Muestra los resultados del compilador en codificación UTF-8.
-verbose Muestra información adicional durante la compilación.
-modulename:<string> Especifica el nombre del módulo de origen.
/preferreduilang Especifica un idioma para los resultados del compilador.

Optimización

Opción Propósito
-filealign Especifica dónde se alinean las secciones del archivo de salida.
-optimize Habilita o deshabilita las optimizaciones.

archivos de salida

Opción Propósito
-doc Procesa los comentarios de documentación generando un archivo XML.
-deterministic Hace que el compilador genere un ensamblado cuyo contenido binario es idéntico en todas las compilaciones si las entradas son idénticas.
-netcf Establece que el compilador tenga como destino .NET Compact Framework.
-out Especifica un directorio de salida.
/refonly Genera solo un ensamblado de referencia.
/refout Especifica la ruta de acceso de salida de un ensamblado de referencia.
-target Especifica el formato de la salida.

Ensamblados .NET

Opción Propósito
-addmodule Hace que el compilador facilite al proyecto que se está compilando toda la información de tipos presente en los archivos especificados.
-delaysign Especifica si el ensamblado estará firmado total o parcialmente.
-imports Importa un espacio de nombres desde un ensamblado especificado.
-keycontainer Especifica un nombre de contenedor de claves para un par de claves que asigna un nombre seguro al ensamblado.
-keyfile Especifica un archivo que contiene una clave o un par de claves que asigna un nombre seguro al ensamblado.
-libpath Especifica la ubicación de los ensamblados a los que se hace referencia con la opción -reference.
-reference Importa metadatos de un ensamblado.
-moduleassemblyname Especifica el nombre del ensamblado del que un módulo formará parte.
-analyzer Ejecuta los analizadores de este ensamblado (forma abreviada: -a).
-additionalfile Asigna nombre a otros archivos que no afectan directamente a la generación de código, pero que los analizadores pueden usar para generar errores o advertencias.

Comprobación de errores y depuración

Opción Propósito
-bugreport Crea un archivo que contiene información que permite notificar un error fácilmente.
-debug Crea información de depuración.
-nowarn Suprime la capacidad del compilador para generar advertencias.
-quiet Evita que el compilador muestre código de errores y advertencias relacionados con la sintaxis.
-removeintchecks Deshabilita las comprobaciones de desbordamiento con enteros.
-warnaserror Promueve las advertencias a errores.
-ruleset:<file> Especifica un archivo de conjunto de reglas que deshabilita diagnósticos específicos.

Ayuda

Opción Propósito
-? Muestra las opciones del compilador. Este comando equivale a especificar la opción -help. No se produce ninguna compilación.
-help Muestra las opciones del compilador. Este comando equivale a especificar la opción -?. No se produce ninguna compilación.

Lenguaje

Opción Propósito
-langversion Especifique la versión de lenguaje: 9|9.0|10|10.0|11|11.0.
-optionexplicit Exige la declaración explícita de variables.
-optionstrict Exige la semántica de tipos estricta.
-optioncompare Especifica si las comparaciones de cadenas deben ser binarias o usar la semántica de texto específica de la configuración regional.
-optioninfer Permite el uso de la inferencia de tipo de variable local en declaraciones de variables.

Preprocesador

Opción Propósito
-define Define símbolos de compilación condicional.

Recursos

Opción Propósito
-linkresource Crea un vínculo a un recurso administrado.
-resource Inserta un recurso administrado en un ensamblado.
-win32icon Inserta un archivo .ico en el archivo de salida.
-win32resource Inserta un recurso Win32 en el archivo de salida.

Varios

Opción Propósito
@ (especificar archivo de respuesta) Especifica un archivo de respuesta.
-baseaddress Especifica la dirección base de un archivo DLL.
-codepage Especifica la página de códigos que se va a usar para todos los archivos de código fuente de la compilación.
-errorreport Especifica cómo debe documentar el compilador de Visual Basic los errores internos del compilador.
-highentropyva Indica al kernel de Windows si un archivo ejecutable determinado admite selección aleatoria del diseño del espacio de direcciones (ASLR) de alta entropía.
-main Especifica la clase que contiene el procedimiento Sub Main que se usa en el inicio.
-noconfig No compila con Vbc.rsp.
-nostdlib Hace que el compilador no haga referencia a las bibliotecas estándar.
-nowin32manifest Indica al compilador que no inserte ningún manifiesto de la aplicación en el archivo ejecutable.
-platform Especifica la plataforma del procesador que el compilador destina para el archivo de salida.
-recurse Busca en los subdirectorios los archivos de código fuente que se deben compilar.
-rootnamespace Especifica un espacio de nombres para todas las declaraciones de tipos.
-sdkpath Especifica la ubicación de Mscorlib.dll y Microsoft.VisualBasic.dll.
-vbruntime Especifica que el compilador debe compilar sin una referencia a la biblioteca de tiempo de ejecución de Visual Basic o con una referencia a una biblioteca de tiempo de ejecución específica.
-win32manifest Identifica un archivo de manifiesto de la aplicación Win32 definido por el usuario que se va a insertar en un archivo ejecutable portable (PE) del proyecto.
-parallel[+&#124;-] Especifica si hay que usar la compilación simultánea (+).
-checksumalgorithm:<alg> Especifique el algoritmo para calcular la suma de comprobación del archivo de origen almacenada en el archivo PDB. Los valores admitidos son: SHA1 (el predeterminado) o SHA256.
Debido a problemas de colisión con SHA1, Microsoft recomienda SHA256 o superior.

Vea también