Partager via

-target (Visual Basic)

Spécifie le format de sortie du compilateur.

Syntaxe

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

Remarques

Le tableau suivant récapitule l’effet de l’option -target .

Option Comportement
-target:exe Provoque la création d’une application console exécutable par le compilateur.

Il s’agit de l’option par défaut quand aucune option n’est -target spécifiée. Le fichier exécutable est créé avec une extension .exe.

Sauf indication contraire avec l’option -out , le nom du fichier de sortie prend le nom du fichier d’entrée qui contient la Sub Main procédure.

Sub Main Une seule procédure est requise dans les fichiers de code source compilés dans un fichier .exe. Utilisez l’option du -main compilateur pour spécifier la classe qui contient la Sub Main procédure.
-target:library Provoque la création d’une bibliothèque de liens dynamiques (DLL).

Le fichier de bibliothèque de liens dynamiques est créé avec une extension .dll.

Sauf indication contraire avec l’option -out , le nom du fichier de sortie prend le nom du premier fichier d’entrée.

Lors de la génération d’une DLL, une Sub Main procédure n’est pas requise.
-target:module Provoque l’ajout du compilateur à un module pouvant être ajouté à un assembly.

Le fichier de sortie est créé avec une extension de .netmodule.

Le Common Language Runtime .NET ne peut pas charger un fichier qui n’a pas d’assembly. Toutefois, vous pouvez incorporer un tel fichier dans le manifeste d’assembly d’un assembly à l’aide -referencede .

Lorsque le code d’un module fait référence à des types internes dans un autre module, les deux modules doivent être incorporés dans un manifeste d’assembly à l’aide -referencede .

L’option -addmodule importe les métadonnées à partir d’un module.
-target:winexe Provoque la création d’une application Windows exécutable.

Le fichier exécutable est créé avec une extension .exe. Une application Windows est une application qui fournit une interface utilisateur à partir de la bibliothèque de classes .NET Framework ou avec les API Windows.

Sauf indication contraire avec l’option -out , le nom du fichier de sortie prend le nom du fichier d’entrée qui contient la Sub Main procédure.

Sub Main Une seule procédure est requise dans les fichiers de code source compilés dans un fichier .exe. Dans les cas où votre code comporte plusieurs classes qui ont une Sub Main procédure, utilisez l’option -main du compilateur pour spécifier la classe qui contient la Sub Main procédure.
-target:appcontainerexe Le compilateur crée une application Windows exécutable qui doit être exécutée dans un conteneur d’application. Ce paramètre est conçu pour être utilisé pour les applications du Windows 8.x Store.

Le paramètre appcontainerexe définit un bit dans le champ Caractéristiques du fichier exécutable portable . Ce bit indique que l’application doit être exécutée dans un conteneur d’application. Lorsque ce bit est défini, une erreur se produit si la CreateProcess méthode tente de lancer l’application en dehors d’un conteneur d’application. Outre ce paramètre de bits, -target :appcontainerexe équivaut à -target :winexe.

Le fichier exécutable est créé avec une extension .exe.

Sauf indication contraire à l’aide de l’option -out , le nom du fichier de sortie prend le nom du fichier d’entrée qui contient la Sub Main procédure.

Sub Main Une seule procédure est requise dans les fichiers de code source compilés dans un fichier .exe. Si votre code contient plusieurs classes qui ont une Sub Main procédure, utilisez l’option -main du compilateur pour spécifier la classe qui contient la Sub Main procédure.
-target:winmdobj Provoque la création d’un fichier intermédiaire que vous pouvez convertir en fichier binaire Windows Runtime (.winmd). Le fichier .winmd peut être consommé par des programmes JavaScript et C++, en plus des programmes de langage managé.

Le fichier intermédiaire est créé avec une extension .winmdobj.

Sauf indication contraire à l’aide de l’option -out , le nom du fichier de sortie prend le nom du premier fichier d’entrée. Une Sub Main procédure n’est pas requise.

Le fichier .winmdobj est conçu pour être utilisé comme entrée pour l’outil WinMDExp d’exportation afin de produire un fichier de métadonnées Windows (WinMD). Le fichier WinMD a une extension .winmd et contient à la fois le code de la bibliothèque d’origine et les définitions WinMD utilisées par JavaScript, C++et Windows Runtime.

Sauf si vous spécifiez -target:module, -target un manifeste d’assembly .NET Framework doit être ajouté à un fichier de sortie.

Chaque instance de Vbc.exe produit, au plus, un fichier de sortie. Si vous spécifiez une option de compilateur telle que -out ou -target plusieurs fois, le dernier processus du compilateur est mis en vigueur. Des informations sur tous les fichiers d’une compilation sont ajoutées au manifeste. Tous les fichiers de sortie, sauf ceux créés avec -target:module des métadonnées d’assembly dans le manifeste. Utilisez Ildasm.exe (désassembleur IL) pour afficher les métadonnées dans un fichier de sortie.

La forme courte est -target-t.

Pour définir -target dans l’IDE Visual Studio

  1. Avoir un projet sélectionné dans l’Explorateur de solutions. Dans le menu Projet, cliquez sur Propriétés.

  2. Cliquez sur l’onglet Application .

  3. Modifiez la valeur dans la zone Type d’application .

Exemple :

Le code suivant compile in.vb, créant in.dll:

vbc -target:library in.vb

Voir aussi