-platform (Visual Basic)

Article
06/05/2023

Spécifie la version de plateforme du CLR (Common Language Runtime) qui peut exécuter le fichier de sortie.

Syntaxe

-platform:{ x86 | x64 | Itanium | arm | anycpu | anycpu32bitpreferred }

Arguments

Terme	Définition
`x86`	Compile votre assembly pour qu'il soit exécuté par le CLR 32 bits x86.
`x64`	Compile votre assembly pour qu'il soit exécuté par le CLR 64 bits sur un ordinateur qui prend en charge le jeu d'instructions AMD64 ou EM64T.
`Itanium`	Compile votre assembly pour qu'il soit exécuté par le CLR 64 bits sur un ordinateur doté d'un processeur Itanium.
`arm`	Compile votre assembly pour qu'il s'exécute sur un ordinateur doté d'un processeur ARM (Advanced RISC Machine).
`anycpu`	Compile votre assembly pour qu'il s'exécute sur n'importe quelle plateforme. L'application s'exécutera en tant qu'application 32 bits sur les versions 32 bits de Windows et en tant qu'application 64 bits sur les versions 64 bits de Windows. Cet indicateur est la valeur par défaut.
`anycpu32bitpreferred`	Compile votre assembly pour qu'il s'exécute sur n'importe quelle plateforme. L'application s'exécutera en tant qu'application 32 bits sur les versions 32 et 64 bits de Windows. Cet indicateur n'est valide que pour les fichiers exécutables (.EXE) et nécessite .NET Framework 4.5.

Notes

Utilisez l'option -platform pour spécifier le type de processeur ciblé par le fichier de sortie.

En général, les assemblys .NET Framework écrits en Visual Basic s'exécutent de la même façon, quelle que soit la plateforme. Cependant, dans certains cas, leur comportement peut varier d'une plateforme à une autre. Voici les cas les plus courants :

Structures contenant des membres qui changent de taille selon la plateforme, comme un type pointeur.
Opération arithmétique de pointeur qui inclut des tailles constantes.
Appel de plateforme incorrect ou déclarations COM qui utilisent Integer pour des handles au lieu de IntPtr.
Cast de IntPtr en Integer.
Utilisation d'un appel de plateforme ou de COM interop avec des composants qui n'existent pas sur toutes les plateformes.

L'option -platform permet de limiter certains problèmes si vous avez émis des hypothèses quant à l'architecture sur laquelle votre code sera exécuté. Plus précisément :

Si vous décidez de cibler une plateforme 64 bits et que l'application est exécutée sur un ordinateur 32 bits, le message d'erreur intervient bien plus tôt et est davantage axé sur le problème que sur l'erreur qui se produit quand ce commutateur n'est pas utilisé.
Si vous définissez l'indicateur x86 au niveau de l'option et que l'application est par la suite exécutée sur un ordinateur 64 bits, l'application s'exécutera dans le sous-système WOW au lieu de s'exécuter en mode natif.

Sur un système d'exploitation Windows 64 bits :

Les assemblys compilés avec -platform:x86 s'exécutent sur le CLR 32 bits fonctionnant sous WOW64.
Les fichiers exécutables compilés avec -platform:anycpu s'exécutent sur le CLR 64 bits.
Une DLL compilée avec -platform:anycpu s'exécute sur le même CLR que le processus dans lequel elle est chargée.
Les fichiers exécutables compilés avec -platform:anycpu32bitpreferred s'exécutent sur le CLR 32 bits.

Pour plus d'informations sur le développement d'une application destinée à s'exécuter sur une version 64 bits de Windows, consultez Applications 64 bits.

Définir -platform dans l'IDE de Visual Studio

Dans l'Explorateur de solutions, choisissez le projet, ouvrez le menu Projet, puis cliquez sur Propriétés.
Sous l'onglet Compiler, cochez ou décochez la case Préférer 32 bits ou, dans la liste Unité centrale cible, choisissez une valeur.

Pour plus d’informations, consultez Page Compiler, Concepteur de projets (Visual Basic).

Exemple

L'exemple suivant montre comment utiliser l'option de compilateur -platform.

vbc -platform:x86 myFile.vb

Partager via