Partilhar via

Configurar a versão da linguagem C#

  • Artigo

As informações neste artigo aplicam-se ao .NET 5 e superior. Para projetos UWP, consulte essas informações no artigo sobre Escolhendo uma versão UWP.

No Visual Studio, a opção para alterar a versão de idioma por meio da interface do usuário é desabilitada porque a versão padrão está alinhada com a estrutura de destino do projeto (TFM). Essa configuração padrão garante a compatibilidade entre os recursos de linguagem e o suporte de tempo de execução. Para alterar a versão de idioma no Visual Studio, altere a estrutura de destino do projeto.

Por exemplo, alterar o TFM de destino (por exemplo, de .NET 6 para .NET 9) atualiza a versão do idioma de acordo, de C# 10 para C# 13. Essa abordagem evita problemas com a compatibilidade de tempo de execução e minimiza erros de compilação inesperados devido a recursos de linguagem sem suporte.

Se você precisar de uma versão de idioma específica que difere da selecionada automaticamente, consulte os métodos neste artigo para substituir as configurações padrão diretamente no arquivo de projeto.

Aviso

Definir o LangVersion elemento como latest é desencorajado. A latest configuração significa que o compilador instalado usa sua versão mais recente. O valor do latest pode mudar de máquina para máquina, tornando as construções não confiáveis. Além disso, ele habilita recursos de linguagem que podem exigir recursos de tempo de execução ou biblioteca não incluídos no SDK atual.

Se você precisar especificar sua versão do C# explicitamente, poderá fazê-lo de várias maneiras:

Gorjeta

Você pode ver a versão do idioma no Visual Studio na página de propriedades do projeto. Na guia Compilar, o painel Avançado exibe a versão selecionada.

Para saber qual versão de idioma estás a usar atualmente, coloca #error version (sensível a maiúsculas e minúsculas) no teu código. Este pragma faz com que o compilador relate um erro do compilador, CS8304, com uma mensagem contendo a versão do compilador e a versão atual do idioma selecionado. Para obter mais informações sobre esse pragma, consulte #error (Referência C#).

Editar o arquivo de projeto

Pode definir a versão linguística no ficheiro de projeto. Por exemplo, se você quiser explicitamente acessar os recursos de visualização, adicione um elemento como o exemplo a seguir:

<PropertyGroup>
   <LangVersion>preview</LangVersion>
</PropertyGroup>

O valor preview usa a versão de linguagem C# de visualização mais recente disponível suportada pelo compilador.

Configurar vários projetos

Para configurar vários projetos C#, você pode criar um arquivo Directory.Build.props, normalmente no diretório da solução, que contém o elemento <LangVersion>. Adicione a seguinte configuração ao arquivo Directory.Build.props :

<Project>
 <PropertyGroup>
   <LangVersion>preview</LangVersion>
 </PropertyGroup>
</Project>

As compilações em todos os subdiretórios do diretório que contém esse arquivo agora usam a versão C# de visualização. Para obter mais informações, consulte Personalizar sua compilação.

Observação

As versões para C# e VB são diferentes. Não use o arquivo de Directory.Build.Props para uma pasta onde os subdiretórios contêm projetos para ambos os idiomas. As versões não correspondem.

Referência da versão da linguagem C#

Importante

Não há suporte para o uso de uma versão de linguagem C# mais recente do que a versão associada ao TFM de destino.

A tabela a seguir mostra todas as versões atuais do idioma C#. Os compiladores mais antigos podem não entender todos os valores. Se você instalar o SDK .NET mais recente, terá acesso a tudo o que está listado.

Valor Significado
preview O compilador aceita toda a sintaxe de idioma válida da versão de visualização mais recente.
latest O compilador aceita sintaxe da versão mais recente lançada do compilador (incluindo a versão secundária).
latestMajor
ou default		 O compilador aceita a sintaxe da última versão principal do compilador.
14.0 O compilador aceita apenas a sintaxe incluída no C# 14 ou inferior.
13.0 O compilador aceita apenas a sintaxe incluída no C# 13 ou inferior.
12.0 O compilador aceita apenas a sintaxe incluída no C# 12 ou inferior.
11.0 O compilador aceita apenas a sintaxe incluída no C# 11 ou inferior.
10.0 O compilador aceita apenas a sintaxe incluída no C# 10 ou inferior.
9.0 O compilador aceita apenas a sintaxe incluída no C# 9 ou inferior.
8.0 O compilador aceita apenas a sintaxe incluída no C# 8.0 ou inferior.
7.3 O compilador aceita apenas a sintaxe incluída no C# 7.3 ou inferior.
7.2 O compilador aceita apenas a sintaxe incluída no C# 7.2 ou inferior.
7.1 O compilador aceita apenas a sintaxe incluída no C# 7.1 ou inferior.
7 O compilador aceita apenas a sintaxe incluída no C# 7.0 ou inferior.
6 O compilador aceita apenas a sintaxe incluída no C# 6.0 ou inferior.
5 O compilador aceita apenas a sintaxe incluída no C# 5.0 ou inferior.
4 O compilador aceita apenas a sintaxe incluída no C# 4.0 ou inferior.
3 O compilador aceita apenas a sintaxe incluída no C# 3.0 ou inferior.
ISO-2
ou 2		 O compilador aceita apenas a sintaxe incluída na ISO/IEC 23270:2006 C# (2.0).
ISO-1
ou 1		 O compilador aceita apenas a sintaxe incluída na ISO/IEC 23270:2003 C# (1.0/1.2).