Selezionare la versione del linguaggio Visual Basic

Per impostazione predefinita viene usata la versione del compilatore Visual Basic corrispondente all'ultima versione principale del linguaggio rilasciata. È possibile scegliere di compilare tutti i progetti usando una nuova versione intermedia del linguaggio. La scelta di una versione più recente del linguaggio consente al progetto di usare le nuove funzionalità del linguaggio. In altri scenari può essere necessario verificare che un progetto viene compilato senza errori quando si usa una versione precedente del linguaggio.

Questa funzionalità separa l'installazione delle nuove versioni dell'SDK e degli strumenti nell'ambiente di sviluppo dalla decisione di incorporare nuove funzionalità del linguaggio in un progetto. È possibile installare l'SDK e gli strumenti più recenti nel computer di compilazione. Ogni progetto può essere configurato per usare una versione specifica del linguaggio in base alla relativa build.

La versione del linguaggio può essere impostata in tre modi:

Modificare il file vbproj

È possibile impostare la versione del linguaggio nel file con estensione .vbproj. Aggiungere l'elemento seguente:

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

Il valore latest usa la versione secondaria più recente del linguaggio Visual Basic. I valori validi sono:

Valore Significato
impostazione predefinita Il compilatore accetta tutte le sintassi di linguaggio valide dalla versione principale più recente supportata.
9 Il compilatore accetta solo la sintassi inclusa in Visual Basic 9.0 o versione precedente.
10 Il compilatore accetta solo la sintassi inclusa in Visual Basic 10.0 o versione precedente.
11 Il compilatore accetta solo la sintassi inclusa in Visual Basic 11.0 o versione precedente.
12 Il compilatore accetta solo la sintassi inclusa in Visual Basic 12.0 o versione precedente.
14 Il compilatore accetta solo la sintassi inclusa in Visual Basic 14.0 o versione precedente.
15 Il compilatore accetta solo la sintassi inclusa in Visual Basic 15.0 o versione precedente.
15.3 Il compilatore accetta solo la sintassi inclusa in Visual Basic 15.3 o versione precedente.
15.5 Il compilatore accetta solo la sintassi inclusa in Visual Basic 15.5 o versione precedente.
16 Il compilatore accetta solo la sintassi inclusa in Visual Basic 16 o versione precedente.
16.9 Il compilatore accetta solo la sintassi inclusa in Visual Basic 16.9 o versione precedente.
più recente Il compilatore accetta tutte le sintassi di linguaggio valide.

Le stringhe speciali default e latest si risolvono rispettivamente nelle versioni principale e secondaria più recenti del linguaggio installate nel computer di compilazione.

Configurare più progetti

È possibile creare un file Directory.build.props che contiene l'elemento <LangVersion> per configurare più directory. Questa operazione viene in genere eseguita nella directory della soluzione. Aggiungere quanto segue a un file Directory.build.props nella directory della soluzione:

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

A questo punto, le compilazioni in tutte le sottodirectory della directory contenente il file useranno la sintassi di Visual Basic versione 15.5. Per altre informazioni, vedere l'articolo Personalizzare la compilazione.

Impostare l'opzione del compilatore langversion

È possibile usare l'opzione della riga di comando -langversion. Per altre informazioni, vedere l'articolo relativo all'opzione del compilatore -langversion. È possibile visualizzare un elenco dei valori validi digitando vbc -langversion:?.