Selecione a versão do idioma Visual Basic

O compilador do Visual Basic assume como padrão a versão principal mais recente da linguagem que foi lançada. Você pode optar por compilar qualquer projeto usando uma nova versão pontual da linguagem. A escolha de uma versão mais recente da língua permite que o seu projeto utilize as funcionalidades linguísticas mais recentes. Em outros cenários, talvez seja necessário validar se um projeto é compilado corretamente ao usar uma versão mais antiga do idioma.

Esse recurso separa a decisão de instalar novas versões do SDK e ferramentas em seu ambiente de desenvolvimento da decisão de incorporar novos recursos de linguagem em um projeto. Você pode instalar o SDK e as ferramentas mais recentes em sua máquina de compilação. Cada projeto pode ser configurado para usar uma versão específica da linguagem para sua compilação.

Existem três formas de definir a versão linguística:

• Edite manualmente seu arquivo .vbproj
• Definir a versão do idioma para vários projetos em um subdiretório
• Configurar a opção do -langversion compilador

Editar o arquivo vbproj

Você pode definir a versão do idioma em seu arquivo .vbproj . Adicione o seguinte elemento:

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

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

Value	Significado
default	O compilador aceita toda a sintaxe de linguagem válida da última versão principal que ele pode suportar.
9	O compilador aceita apenas sintaxe que está incluída no Visual Basic 9.0 ou inferior.
10	O compilador aceita apenas sintaxe incluída no Visual Basic 10.0 ou inferior.
11	O compilador aceita apenas sintaxe incluída no Visual Basic 11.0 ou inferior.
12	O compilador aceita apenas sintaxe incluída no Visual Basic 12.0 ou inferior.
14	O compilador aceita apenas sintaxe que está incluída no Visual Basic 14.0 ou inferior.
15	O compilador aceita apenas sintaxe incluída no Visual Basic 15.0 ou inferior.
15,3	O compilador aceita apenas sintaxe incluída no Visual Basic 15.3 ou inferior.
15,5	O compilador aceita apenas sintaxe incluída no Visual Basic 15.5 ou inferior.
16	O compilador aceita apenas sintaxe incluída no Visual Basic 16 ou inferior.
16,9	O compilador aceita apenas sintaxe incluída no Visual Basic 16.9 ou inferior.
mais recente	O compilador aceita toda a sintaxe de linguagem válida que ele pode suportar.

As cadeias de caracteres especiais e latest resolvem para as versões de idioma principais e secundárias mais recentes instaladas default na máquina de compilação, respectivamente.

Configurar vários projetos

Você pode criar um arquivo Directory.build.props que contém o <LangVersion> elemento 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 da solução:

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

Agora, compilações em cada subdiretório do diretório que contém esse arquivo usará a sintaxe do Visual Basic versão 15.5. Para obter mais informações, consulte o artigo sobre Personalizar sua compilação.

Definir a opção do compilador langversion

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