Partage via


Sélectionner la version de langage Visual Basic

Par défaut, le compilateur Visual Basic utilise la dernière version principale du langage mis en production. Vous pouvez choisir de compiler n’importe quel projet à l’aide d’une nouvelle version intermédiaire du langage. En choisissant une version plus récente du langage, vous permettez à votre projet d’utiliser les dernières fonctionnalités de langage. Dans d’autres scénarios, vous devrez peut-être vérifier qu’un projet est correctement compilé en cas d’utilisation d’une ancienne version de langage.

Cette fonctionnalité dissocie la décision d’installer de nouvelles versions du kit SDK et des outils dans votre environnement de développement de la décision d’incorporer de nouvelles fonctionnalités de langage dans un projet. Vous pouvez installer la dernière version du SDK et des outils sur votre ordinateur de build. Chaque projet peut être configuré pour utiliser une version spécifique du langage pour sa build.

Il existe plusieurs façons de définir la version de langage :

Modifier le fichier vbproj

Vous pouvez définir la version de langage dans votre fichier .vbproj. Ajoutez l’élément suivant :

<PropertyGroup>
   <LangVersion>latest</LangVersion>
</PropertyGroup>

La valeur latest utilise la dernière version mineure du langage Visual Basic. Les valeurs autorisées sont :

Valeur Signification
default Le compilateur accepte toute la syntaxe de langage valide de la dernière version principale qu’il peut prendre en charge.
9 Le compilateur accepte uniquement la syntaxe incluse dans Visual Basic 9.0 ou une version antérieure.
10 Le compilateur accepte uniquement la syntaxe incluse dans Visual Basic 10.0 ou une version antérieure.
11 Le compilateur accepte uniquement la syntaxe incluse dans Visual Basic 11.0 ou une version antérieure.
12 Le compilateur accepte uniquement la syntaxe incluse dans Visual Basic 12.0 ou une version antérieure.
14 Le compilateur accepte uniquement la syntaxe incluse dans Visual Basic 14.0 ou une version antérieure.
15 Le compilateur accepte uniquement la syntaxe incluse dans Visual Basic 15.0 ou une version antérieure.
15,3 Le compilateur accepte uniquement la syntaxe incluse dans Visual Basic 15.3 ou une version antérieure.
15,5 Le compilateur accepte uniquement la syntaxe incluse dans Visual Basic 15.5 ou une version antérieure.
16 Le compilateur accepte uniquement la syntaxe incluse dans Visual Basic 16 ou une version antérieure.
16,9 Le compilateur accepte uniquement la syntaxe incluse dans Visual Basic 16.9 ou une version antérieure.
latest Le compilateur accepte toute la syntaxe de langage valide qu’il peut prendre en charge.

Les chaînes spéciales default et latest définissent respectivement la dernière version majeure et la dernière version mineure du langage installées sur l’ordinateur de build.

Configurer plusieurs projets

Vous pouvez créer un fichier Directory.build.props contenant l’élément <LangVersion> pour configurer plusieurs répertoires. En règle générale, vous faites cela dans votre répertoire de solution. Ajoutez ce qui suit à un fichier Directory.build.props dans votre répertoire de solution :

<Project>
 <PropertyGroup>
   <LangVersion>15.5</LangVersion>
 </PropertyGroup>
</Project>

Les builds de chaque sous-répertoire du répertoire contenant ce fichier utilisent désormais la syntaxe Visual Basic version 15.5. Pour plus d’informations, consultez l’article sur Personnaliser votre build.

Définir l’option de compilateur langversion

Vous pouvez utiliser l’option de ligne de commande -langversion. Pour plus d’informations, consultez l’article sur l’option de compilateur -langversion. Vous pouvez consulter une liste des valeurs valides en tapant vbc -langversion:?.