C# Palavras-chave

Palavras-chave são as palavras que o próprio C# usa: if, class, int, return… Esta página lista todas, cada uma com o que faz, um exemplo curto e a aula que ensina. Elas são de dois tipos: as reservadas, que nunca podem ser nome de variável, e as contextuais, que só são especiais em certos lugares do código.

As duas listas foram conferidas no compilador do laboratório (o dotnet 10.0.112, C# 14): cada palavra foi usada como nome de variável (int palavra = 1;), e as reservadas são exatamente as que deram erro.

Atalhos: Reservadas · Tipos · Valores · Decisões e laços · Exceções · Declarar tipos · Modificadores · Métodos e objetos · Operadores-palavra · Avançadas · Contextuais · Quando dá errado · Experimente

As palavras reservadas

São 77, todas em minúsculas. Nenhuma pode ser nome de variável, método ou classe (a não ser com @ na frente, veja Quando dá errado):

abstract  as        base      bool      break     byte      case      catch
char      checked   class     const     continue  decimal   default   delegate
do        double    else      enum      event     explicit  extern    false
finally   fixed     float     for       foreach   goto      if        implicit
in        int       interface internal  is        lock      long      namespace
new       null      object    operator  out       override  params    private
protected public    readonly  ref       return    sbyte     sealed    short
sizeof    stackalloc static   string    struct    switch    this      throw
true      try       typeof    uint      ulong     unchecked unsafe    ushort
using     virtual   void      volatile  while

Como o C# diferencia maiúsculas de minúsculas, Class, INT e If não são palavras-chave. Compilam, mas confundem quem lê: não use.

Tipos

Cada uma é um apelido para um tipo do .NET: int é o mesmo que System.Int32. Os tamanhos e limites estão em Tipos e Limites.

Valores

Decisões e laços

Exceções e estouro

Declarar tipos e organizar

Modificadores

Métodos, parâmetros e objetos

Operadores que são palavras

Avançadas (código inseguro e memória)

Palavras-chave contextuais

Estas só têm significado especial em certos lugares. Fora deles, são nomes comuns: string var = "ok"; e int record = 14; compilam. Por isso o C# pôde ganhar palavras novas (como record, em 2020, e field, em 2025) sem quebrar programas antigos que já usavam esses nomes. Mesmo assim, evite usá-las como nome: confunde quem lê.

Duas contextuais em ação: field C# 14 poupa declarar o campo de uma propriedade que limpa o texto, e extension C# 14 acrescenta um método ao string:

Produto p = new() { Nome = "  caderno  " };
Console.WriteLine($"[{p.Nome}]");
Console.WriteLine("lojinha".Gritar());

class Produto
{
    public string Nome
    {
        get => field;
        set => field = value.Trim();
    } = "";
}

static class Extensoes
{
    extension(string s)
    {
        public string Gritar() => s.ToUpper() + "!";
    }
}

$ dotnet run novos.cs
[caderno]
LOJINHA!

Quando dá errado

double base = 4;
double altura = 3;
Console.WriteLine($"Área: {base * altura / 2}");

$ dotnet run triangulo.cs
/home/ana/cs/kw/triangulo.cs(1,8): error CS1001: Identificador esperado
/home/ana/cs/kw/triangulo.cs(1,8): error CS1003: Erro de sintaxe, "," esperado

Ocorreu uma falha no build. Corrija os erros de build e execute novamente.

int @class = 5;
string var = "contextual";
int record = 14;
Console.WriteLine($"{@class} {var} {record}");

$ dotnet run arroba.cs
5 contextual 14

Experimente

double base = 4;
double altura = 3;
Console.WriteLine($"Área: {base * altura / 2}");

double lado = 4;
double altura = 3;
Console.WriteLine($"Área: {lado * altura / 2}");

Resumo

• O C# 14 tem 77 palavras reservadas, todas em minúsculas. Nenhuma pode ser nome, a não ser com @ (@class).
• Usar uma reservada como nome dá CS1001: Identificador esperado, às vezes com uma cascata de outros erros na mesma linha.
• As contextuais (var, record, async, field…) só são especiais em certos lugares; fora deles, são nomes comuns. É assim que a linguagem ganha palavras novas sem quebrar código antigo.
• Os tipos (int, string, bool…) são apelidos de tipos do .NET: int = System.Int32.
• args, Main e Console não são palavras-chave.