Compartir a través de


-target (Visual Basic)

Especifica el formato de la salida del compilador.

Sintaxis

-target:{exe | library | module | winexe | appcontainerexe | winmdobj}

Observaciones

En la tabla siguiente se resume el efecto de la -target opción.

Opción Comportamiento
-target:exe Hace que el compilador cree una aplicación de consola ejecutable.

Esta es la opción predeterminada cuando no se especifica ninguna -target opción. El archivo ejecutable se crea con una extensión .exe.

A menos que se especifique lo contrario con la -out opción , el nombre del archivo de salida toma el nombre del archivo de entrada que contiene el Sub Main procedimiento.

Solo se requiere un Sub Main procedimiento en los archivos de código fuente que se compilan en un archivo .exe. Use la -main opción del compilador para especificar qué clase contiene el Sub Main procedimiento.
-target:library Hace que el compilador cree una biblioteca de vínculos dinámicos (DLL).

El archivo de biblioteca de vínculos dinámicos se crea con una extensión .dll.

A menos que se especifique lo contrario con la -out opción , el nombre del archivo de salida toma el nombre del primer archivo de entrada.

Al compilar un archivo DLL, no se requiere un Sub Main procedimiento.
-target:module Hace que el compilador genere un módulo que se pueda agregar a un ensamblado.

El archivo de salida se crea con una extensión de .netmodule.

Common Language Runtime de .NET no puede cargar un archivo que no tenga un ensamblado. Sin embargo, puede incorporar este archivo en el manifiesto de ensamblado de un ensamblado mediante -reference.

Cuando el código de un módulo hace referencia a tipos internos en otro módulo, ambos módulos deben incorporarse en un manifiesto de ensamblado mediante -reference.

La opción -addmodule importa metadatos de un módulo.
-target:winexe Hace que el compilador cree una aplicación basada en Windows ejecutable.

El archivo ejecutable se crea con una extensión .exe. Una aplicación basada en Windows es una que proporciona una interfaz de usuario desde la biblioteca de clases de .NET Framework o con las API de Windows.

A menos que se especifique lo contrario con la -out opción , el nombre del archivo de salida toma el nombre del archivo de entrada que contiene el Sub Main procedimiento.

Solo se requiere un Sub Main procedimiento en los archivos de código fuente que se compilan en un archivo .exe. En los casos en los que el código tiene más de una clase que tiene un Sub Main procedimiento, use la -main opción del compilador para especificar qué clase contiene el Sub Main procedimiento.
-target:appcontainerexe Hace que el compilador cree una aplicación ejecutable basada en Windows que se debe ejecutar en un contenedor de aplicaciones. Esta configuración está diseñada para usarse para aplicaciones de la Tienda Windows 8.x.

El valor appcontainerexe establece un poco en el campo Características del archivo ejecutable portátil . Este bit indica que la aplicación debe ejecutarse en un contenedor de aplicaciones. Cuando se establece este bit, se produce un error si el CreateProcess método intenta iniciar la aplicación fuera de un contenedor de aplicaciones. Aparte de esta configuración de bits, -target:appcontainerexe es equivalente a -target:winexe.

El archivo ejecutable se crea con una extensión .exe.

A menos que especifique lo contrario mediante la -out opción , el nombre del archivo de salida toma el nombre del archivo de entrada que contiene el Sub Main procedimiento.

Solo se requiere un Sub Main procedimiento en los archivos de código fuente que se compilan en un archivo .exe. Si el código contiene más de una clase que tiene un Sub Main procedimiento, use la -main opción del compilador para especificar qué clase contiene el Sub Main procedimiento.
-target:winmdobj Hace que el compilador cree un archivo intermedio que pueda convertir en un archivo binario (.winmd) de Windows Runtime. El archivo .winmd puede ser consumido por programas de JavaScript y C++, además de programas de lenguaje administrado.

El archivo intermedio se crea con una extensión .winmdobj.

A menos que especifique lo contrario mediante la -out opción , el nombre del archivo de salida toma el nombre del primer archivo de entrada. No se requiere un Sub Main procedimiento.

El archivo .winmdobj está diseñado para usarse como entrada para la WinMDExp herramienta de exportación para generar un archivo de metadatos de Windows (WinMD). El archivo WinMD tiene una extensión .winmd y contiene el código de la biblioteca original y las definiciones de WinMD que javaScript, C++y Windows Runtime usan.

A menos que especifique -target:module, -target hace que se agregue un manifiesto de ensamblado de .NET Framework a un archivo de salida.

Cada instancia de Vbc.exe produce, como máximo, un archivo de salida. Si especifica una opción del compilador como -out o -target más de una vez, el último proceso del compilador se pone en vigor. Se agrega información sobre todos los archivos de una compilación al manifiesto. Todos los archivos de salida excepto los creados con -target:module contienen metadatos de ensamblado en el manifiesto. Use Ildasm.exe (Desensamblador de IL) para ver los metadatos en un archivo de salida.

La forma abreviada de -target es -t.

Para establecer -target en el IDE de Visual Studio

  1. Seleccione un proyecto en el Explorador de soluciones. En el menú Proyecto , haga clic en Propiedades.

  2. Haga clic en la pestaña Aplicación .

  3. Modifique el valor en el cuadro Tipo de aplicación .

Ejemplo

El código siguiente compila in.vb, creando in.dll:

vbc -target:library in.vb

Consulte también