-target (Visual Basic)

  • Article

Spécifie le format de la sortie du compilateur.

Syntaxe

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

Notes

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 lorsqu’aucune option -target n’est spécifiée. Le fichier exécutable est créé avec une extension .exe.

À moins que l’option -out spécifie autre chose, le fichier de sortie prend le nom du fichier d’entrée qui contient la procédure Sub Main.

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

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

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

Lors de la génération d’une DLL, une procédure Sub Main n’est pas obligatoire.
-target:module Oblige le compilateur à générer un module qui peut être ajouté à un assembly.

Le fichier de sortie est créé avec une extension .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 avec -reference.

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 de -reference.

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

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.

À moins que l’option -out spécifie autre chose, le fichier de sortie prend le nom du fichier d’entrée qui contient la procédure Sub Main.

Une seule procédure Sub Main 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 procédure Sub Main, utilisez l’option de compilateur -main pour spécifier la classe qui contient la procédure Sub Main
-target:appcontainerexe Oblige le compilateur à créer 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 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 méthode CreateProcess tente de lancer l’application en dehors d’un conteneur d’application. En dehors de ce paramètre de bit, -target:appcontainerexe est équivalent à -target:winexe.

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

À moins que l’option -out spécifie un autre comportement, le fichier de sortie prend le nom du fichier d’entrée qui contient la procédure Sub Main.

Une seule procédure Sub Main est requise dans les fichiers de code source compilés dans un fichier .exe. Si votre code contient plusieurs classes qui ont une procédure Sub Main, utilisez l’option de compilateur -main pour spécifier la classe qui contient la procédure Sub Main
-target:winmdobj Le compilateur crée 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 en langage managé.

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

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

Le fichier .winmdobj est conçu pour être utilisé comme entrée pour l’outil d’exportation WinMDExp 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 que JavaScript, C++, et Windows Runtime utilisent.

Sauf si vous spécifiez -target:module, -target entraîne l’ajout d’un manifeste de l’assembly .NET Framework dans un fichier de sortie.

Chaque instance de Vbc.exe produit, au maximum, un fichier de sortie. Si vous spécifiez une option de compilateur, comme -out ou -target, plusieurs fois, la dernière que le compilateur traite s’applique. 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, contiennent 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 abrégée de -target est -t.

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

  1. Sélectionnez un projet 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 ainsi in.dll :

vbc -target:library in.vb

Voir aussi