Partilhar via


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:

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:? .