Selecionar a versão da linguagem do Visual Basic

  • Artigo

O compilador Visual Basic usa como padrão a última versão principal da linguagem que foi liberada. Você pode optar por compilar qualquer projeto usando uma nova versão de ponto da linguagem. A escolha de uma versão mais recente da linguagem permite que o projeto use as últimas funcionalidades da linguagem. Em outros cenários, talvez você precise validar se um projeto é compilado por completo ao usar uma versão mais antiga da linguagem.

Essa funcionalidade separa a decisão de instalar novas versões do SDK e das ferramentas no ambiente de desenvolvimento da decisão de incorporar novas funcionalidades da linguagem em um projeto. Instale o último SDK e as últimas ferramentas no computador de build. Cada projeto pode ser configurado para usar uma versão específica da linguagem de seu build.

Há várias maneiras de definir a versão da linguagem:

Editar o arquivo vbproj

Você pode definir a versão da linguagem no arquivo .vbproj. Adicione o seguinte elemento:

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

O valor latest usa a última versão secundária da linguagem Visual Basic. Os valores válidos são:

Valor Significado
padrão O compilador aceita toda a sintaxe de linguagem válida da versão principal mais recente à qual dá suporte.
9 O compilador aceita somente a sintaxe incluída no Visual Basic 9.0 ou inferior.
10 O compilador aceita somente a sintaxe incluída no Visual Basic 10.0 ou inferior.
11 O compilador aceita somente a sintaxe incluída no Visual Basic 11.0 ou inferior.
12 O compilador aceita somente a sintaxe incluída no Visual Basic 12.0 ou inferior.
14 O compilador aceita somente a sintaxe incluída no Visual Basic 14.0 ou inferior.
15 O compilador aceita somente a sintaxe incluída no Visual Basic 15.0 ou inferior.
15.3 O compilador aceita somente a sintaxe incluída no Visual Basic 15.3 ou inferior.
15.5 O compilador aceita somente a sintaxe incluída no Visual Basic 15.5 ou inferior.
16 O compilador aceita somente a sintaxe incluída no Visual Basic 16 ou inferior.
16,9 O compilador aceita somente a sintaxe incluída no Visual Basic 16.9 ou inferior.
mais recente O compilador aceita toda a sintaxe de linguagem à qual dá suporte.

As cadeias de caracteres especiais default e latest são resolvidas nas últimas versões da linguagem principal e secundária instaladas no computador de build, respectivamente.

Configurar vários projetos

Crie um arquivo Directory.build.props que contém o elemento <LangVersion> para configurar vários diretórios. Normalmente, você faz isso no diretório da solução. Adicione o seguinte a um arquivo Directory.build.props no diretório de solução:

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

Agora, os builds de cada subdiretório do diretório que contém esse arquivo usarão a sintaxe Visual Basic versão 15.5. Para obter mais informações, confira o artigo sobre como personalizar o build.

Definir a opção langversion do compilador

Você pode usar a opção -langversion da linha de comando. Para obter mais informações, confira o artigo sobre a opção -langversion do compilador. Veja uma lista dos valores válidos digitando vbc -langversion:?.