Selección de la versión del lenguaje Visual Basic

  • Artículo

El compilador de Visual Basic tiene como valor predeterminado la versión principal más reciente del lenguaje que se haya publicado. Puede elegir compilar cualquier proyecto con una versión nueva del lenguaje. Elegir la versión más reciente del lenguaje permite que el proyecto use las últimas características de ese lenguaje. En otros escenarios, puede ser necesario validar que un proyecto se compile correctamente cuando se usa una versión anterior del lenguaje.

Esta capacidad hace que la decisión de instalar nuevas versiones del SDK y las herramientas en el entorno de desarrollo no esté vinculada a la decisión de incorporar nuevas características del lenguaje en un proyecto. Puede instalar el SDK y las herramientas más recientes en el equipo de compilación. Cada proyecto se puede configurar para que, durante su compilación, se use una versión de lenguaje específica.

Hay tres maneras de establecer la versión de idioma:

Edición del archivo vbproj

Puede establecer la versión del lenguaje en el archivo .vbproj. Agregue el elemento siguiente:

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

El valor latest usa la versión secundaria más reciente del lenguaje Visual Basic. Los valores válidos son:

Value Significado
default El compilador acepta toda la sintaxis de lenguaje válida de la última versión principal que puede admitir.
9 El compilador solo acepta la sintaxis que se incluye en Visual Basic 9.0 o versiones anteriores.
10 El compilador solo acepta la sintaxis que se incluye en Visual Basic 10.0 o versiones anteriores.
11 El compilador solo acepta la sintaxis que se incluye en Visual Basic 11.0 o versiones anteriores.
12 El compilador solo acepta la sintaxis que se incluye en Visual Basic 12.0 o versiones anteriores.
14 El compilador solo acepta la sintaxis que se incluye en Visual Basic 14.0 o versiones anteriores.
15 El compilador solo acepta la sintaxis que se incluye en Visual Basic 15.0 o versiones anteriores.
15,3 El compilador solo acepta la sintaxis que se incluye en Visual Basic 15.3 o versiones anteriores.
15,5 El compilador solo acepta la sintaxis que se incluye en Visual Basic 15.5 o versiones anteriores.
16 El compilador solo acepta la sintaxis que se incluye en Visual Basic 16 o versiones anteriores.
16,9 El compilador solo acepta la sintaxis que se incluye en Visual Basic 16.9 o versiones anteriores.
latest El compilador acepta toda la sintaxis de lenguaje válida que puede admitir.

Las cadenas especiales default y latest se resuelven en las versiones de lenguaje principal y secundaria respectivamente más recientes que haya instaladas en el equipo de compilación.

Configurar varios proyectos

Puede crear un archivo Directory.build.props que contenga el elemento <LangVersion> para configurar varios directorios. Por lo general, esto se hace en el directorio de la solución. Agregue lo siguiente a un archivo Directory.build.props en el directorio de la solución:

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

Ahora, las compilaciones de cada subdirectorio del directorio que contenga ese archivo usarán la sintaxis de la versión 15.5 de Visual Basic. Para obtener más información, consulte el artículo Personalizar una compilación.

Establecer la opción del compilador langversion

Puede usar la opción de la línea de comandos -langversion. Para obtener más información, consulte el artículo sobre la opción del compilador -langversion. Escriba vbc -langversion:? para una lista de los valores válidos.