-target (Visual Basic)

  • Articolo

Specifica il formato del compilatore.

Sintassi

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

Osservazioni:

Nella tabella seguente vengono riepilogati gli effetti dell'opzione -target.

Opzione Comportamento
-target:exe Indica al compilatore di creare un'applicazione console eseguibile.

Questa è l'opzione predefinita quando non viene specificata alcuna opzione -target. Il file eseguibile viene creato con estensione .exe.

Se non diversamente specificato con l'opzione -out, il nome del file di output corrisponderà al nome del file di input contenente la routine Sub Main.

È necessaria una sola procedura Sub Main nei file del codice sorgente che vengono compilati in un file con estensione exe. Usare l'opzione del compilatore -main per specificare la classe contenente la routine Sub Main.
-target:library Fa sì che il compilatore crei una libreria di collegamento dinamico (DLL).

Il file della libreria a collegamento dinamico viene creato con un'estensione .dll.

Se non diversamente specificato tramite l'opzione -out, il nome del file di output corrisponderà al nome del primo file di input.

Quando si compila una DLL, non è necessaria una routine Sub Main.
-target:module Fa in modo che il compilatore generi un modulo che può essere aggiunto a un assembly.

Il file di output viene creato con un'estensione di .netmodule.

Common Language Runtime .NET non può caricare un file che non dispone di un assembly. È tuttavia possibile incorporare tale file nel manifesto dell'assembly usando -reference.

Quando il codice in un modulo fa riferimento a tipi interni in un altro modulo, entrambi i moduli devono essere incorporati in un manifesto dell'assembly usando -reference.

L'opzione -addmodule importa i metadati da un modulo.
-target:winexe Indica al compilatore di creare un'applicazione basata su Windows eseguibile.

Il file eseguibile viene creato con estensione .exe. Un'applicazione basata su Windows fornisce un'interfaccia utente dalla libreria di classi .NET Framework o con le API di Windows.

Se non diversamente specificato con l'opzione -out, il nome del file di output corrisponderà al nome del file di input contenente la routine Sub Main.

È necessaria una sola procedura Sub Main nei file del codice sorgente che vengono compilati in un file con estensione exe. Se il codice contiene più classi con una routine Sub Main, usare l'opzione del compilatore -main per specificare la classe contenente la routine Sub Main
-target:appcontainerexe Fa sì che il compilatore crei un'applicazione basata su Windows eseguibile che deve essere eseguita in un contenitore di app. Questa impostazione è progettata per essere usata per le applicazioni Windows 8.x Store.

L'impostazione appcontainerexe imposta un bit nel campo Caratteristiche del file eseguibile portabile. Questo bit indica che l'app deve essere eseguita in un contenitore di app. Quando questo bit è impostato, si verifica un errore se il metodo CreateProcess tenta di avviare l'applicazione all'esterno di un contenitore di app. A parte questa impostazione di bit, -target:appcontainerexe equivale a -target:winexe.

Il file eseguibile viene creato con estensione .exe.

Se non diversamente specificato con l'opzione -out, il nome del file di output corrisponderà al nome del file di input contenente la routine Sub Main.

È necessaria una sola procedura Sub Main nei file del codice sorgente che vengono compilati in un file con estensione exe. Se il codice contiene più classi con una routine Sub Main, usare l'opzione del compilatore -main per specificare la classe contenente la routine Sub Main
-target:winmdobj Fa in modo che il compilatore crei un file intermedio che puoi convertire in un file binario di Windows Runtime (con estensione winmd). Il file con estensione winmd può essere utilizzato dai programmi C++ e JavaScript, oltre ai programmi di linguaggi gestiti.

Il file intermedio viene creato con un'estensione winmdobj.

Se non diversamente specificato tramite l'opzione -out, il nome del file di output corrisponderà al nome del primo file di input. Non è necessaria una routine Sub Main.

Il file con estensione winmdobj è progettato per essere usato come input per lo strumento di esportazione WinMDExp per produrre un file di metadati Windows (WinMD). Il file WinMD ha un'estensione winmd e contiene il codice della libreria originale e le definizioni WinMD utilizzati da JavaScript, C++ e Windows Runtime.

A meno che non si specifichi -target:module, -target causa l'aggiunta di un manifesto dell'assembly .NET Framework a un file di output.

Ogni istanza di Vbc.exe produce al massimo un file di output. Se si specifica un'opzione del compilatore, ad esempio -out o -target più di una volta, viene applicato l'ultimo processo del compilatore. Le informazioni su tutti i file in una compilazione vengono aggiunte al manifesto. Tutti i file di output, ad eccezione di quelli creati con -target:module, contengono metadati di assembly nel manifesto. Usare Ildasm.exe (disassemblatore IL) per visualizzare i metadati in un file di output.

La forma breve di -target è -t.

Per impostare -target nell'IDE di Visual Studio

  1. Selezionare un progetto in Esplora soluzioni. Scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Applicazione .

  3. Modificare il valore nella casella Tipo di applicazione.

Esempio

Il codice seguente compila in.vb, creando in.dll:

vbc -target:library in.vb

Vedi anche