Variáveis locais de tipo implícito (Guia de Programação em C#)

  • Artigo

Variáveis locais podem ser declaradas sem fornecer um tipo explícito. A palavra-chave var instrui o compilador a inferir o tipo da variável da expressão no lado direito da instrução de inicialização. O tipo inferido pode ser um tipo interno, um tipo anônimo, um tipo definido pelo usuário ou um tipo definido na biblioteca de classes .NET. Para obter mais informações sobre como inicializar matrizes com var, consulte Matrizes de tipo implícito.

Os exemplos a seguir mostram várias maneiras em que as variáveis locais podem ser declaradas com var:

// i is compiled as an int
var i = 5;

// s is compiled as a string
var s = "Hello";

// a is compiled as int[]
var a = new[] { 0, 1, 2 };

// expr is compiled as IEnumerable<Customer>
// or perhaps IQueryable<Customer>
var expr =
    from c in customers
    where c.City == "London"
    select c;

// anon is compiled as an anonymous type
var anon = new { Name = "Terry", Age = 34 };

// list is compiled as List<int>
var list = new List<int>();

É importante entender que a palavra-chave var não significa "variante" e não indica que a variável é vagamente tipada ou de associação tardia. Isso apenas significa que o compilador determina e atribui o tipo mais apropriado.

A palavra-chave var pode ser usada nos seguintes contextos:

  • Em variáveis locais (variáveis declaradas no escopo do método) conforme mostrado no exemplo anterior.

  • Em uma instrução de inicialização for.

    for (var x = 1; x < 10; x++)

  • Em uma instrução de inicialização foreach.

    foreach (var item in list) {...}

  • Em uma instrução using.

    using (var file = new StreamReader("C:\\myfile.txt")) {...}

Para obter mais informações, consulte Como usar matrizes e variáveis locais de tipo implícito em uma expressão de consulta.

Tipos var e anônimos

Em muitos casos, o uso de var é opcional e é apenas uma conveniência sintática. No entanto, quando uma variável é inicializada com um tipo anônimo você deve declarar a variável como var se precisar acessar as propriedades do objeto em um momento posterior. Esse é um cenário comum em expressões de consulta LINQ. Para obter mais informações, consulte Tipos Anônimos.

Da perspectiva do código-fonte, um tipo anônimo não tem nome. Portanto, se uma variável de consulta tiver sido inicializada com var, a única maneira de acessar as propriedades na sequência retornada será usar var como o tipo da variável de iteração na instrução foreach.

class ImplicitlyTypedLocals2
{
    static void Main()
    {
        string[] words = { "aPPLE", "BlUeBeRrY", "cHeRry" };

        // If a query produces a sequence of anonymous types,
        // then use var in the foreach statement to access the properties.
        var upperLowerWords =
             from w in words
             select new { Upper = w.ToUpper(), Lower = w.ToLower() };

        // Execute the query
        foreach (var ul in upperLowerWords)
        {
            Console.WriteLine("Uppercase: {0}, Lowercase: {1}", ul.Upper, ul.Lower);
        }
    }
}
/* Outputs:
    Uppercase: APPLE, Lowercase: apple
    Uppercase: BLUEBERRY, Lowercase: blueberry
    Uppercase: CHERRY, Lowercase: cherry
 */

Comentários

As seguintes restrições se aplicam às declarações de variável de tipo implícito:

  • var pode ser usado apenas quando uma variável local é declarada e inicializada na mesma instrução, a variável não pode ser inicializada como nula, um grupo de métodos ou uma função anônima.

  • var não pode ser usado em campos no escopo da classe.

  • Variáveis declaradas usando var não podem ser usadas na expressão de inicialização. Em outras palavras, essa expressão é válida: int i = (i = 20);, mas essa expressão gera um erro em tempo de compilação: var i = (i = 20);

  • Diversas variáveis de tipo implícito não podem ser inicializadas na mesma instrução.

  • Se um tipo nomeado var estiver no escopo, a palavra-chave var será resolvida para esse nome de tipo e não será tratada como parte de uma declaração de variável local de tipo implícito.

Tipagem implícita com a palavra-chave var só pode ser aplicada às variáveis no escopo do método local. Digitação implícita não está disponível para os campos de classe, uma vez que o compilador C# encontraria um paradoxo lógico ao processar o código: o compilador precisa saber o tipo do campo, mas não é possível determinar o tipo até que a expressão de atribuição seja analisada. A expressão não pode ser avaliada sem saber o tipo. Considere o seguinte código:

private var bookTitles;

bookTitles é um campo de classe dado o tipo var. Como o campo não tem nenhuma expressão para avaliar, é impossível para o compilador inferir que tipo bookTitles deveria ser. Além disso, também é insuficiente adicionar uma expressão ao campo (como você faria para uma variável local):

private var bookTitles = new List<string>();

Quando o compilador encontra campos durante a compilação de código, ele registra cada tipo de campo antes de processar quaisquer expressões associadas. O compilador encontra o mesmo paradoxo ao tentar analisar bookTitles: ele precisa saber o tipo do campo, mas o compilador normalmente determinaria o tipo de var analisando a expressão, o que não possível sem saber o tipo com antecedência.

Você pode descobrir que var também pode ser útil com expressões de consulta em que o tipo construído exato da variável de consulta é difícil de ser determinado. Isso pode ocorrer com operações de agrupamento e classificação.

A palavra-chave var também pode ser útil quando o tipo específico da variável é enfadonho de digitar no teclado, é óbvio ou não acrescenta à legibilidade do código. Um exemplo em que var é útil dessa maneira é com os tipos genéricos aninhados, como os usados com operações de grupo. Na consulta a seguir, o tipo da variável de consulta é IEnumerable<IGrouping<string, Student>>. Contanto que você e as outras pessoas que devem manter o código entendam isso, não há problema em usar a tipagem implícita por questões de conveniência e brevidade.

// Same as previous example except we use the entire last name as a key.
// Query variable is an IEnumerable<IGrouping<string, Student>>
var studentQuery3 =
    from student in students
    group student by student.Last;

O uso de var ajuda a simplificar o código, mas seu uso deve ser restrito a casos em que ele é necessário ou facilita a leitura do código. Para obter mais informações sobre quando usar var corretamente, confira a seção Variáveis locais digitados implicitamente no artigo Diretrizes de Codificação de C#.

Confira também