Como inicializar um dicionário com um inicializador de coleção (Guia de Programação em C#)

  • Artigo

Um Dictionary<TKey,TValue> contém uma coleção de pares de chave-valor. Seu método Add recebe dois parâmetros, um para a chave e outro para o valor. Uma maneira de inicializar um Dictionary<TKey,TValue> ou qualquer coleção cujo método Add use vários parâmetros, é colocar cada conjunto de parâmetros entre chaves, conforme mostrado no exemplo a seguir. Outra opção é usar um inicializador de índice, também mostrado no exemplo a seguir.

Observação

A principal diferença entre essas duas maneiras de inicializar a coleção é que, no caso de ter chaves duplicadas, por exemplo:

{ 111, new StudentName { FirstName="Sachin", LastName="Karnik", ID=211 } },
{ 111, new StudentName { FirstName="Dina", LastName="Salimzianova", ID=317 } },

O método Add gerará ArgumentException: 'An item with the same key has already been added. Key: 111', enquanto a segunda parte do exemplo, o método de indexador público de leitura/gravação, substituirá silenciosamente a entrada já existente com a mesma chave.

Exemplo

No exemplo de código a seguir, um Dictionary<TKey,TValue> é inicializado com instâncias do tipo StudentName. A primeira inicialização usa o método Add com dois argumentos. O compilador gera uma chamada para Add para cada um dos pares de chaves int e valores StudentName. A segunda usa um método de indexador público de leitura/gravação da classe Dictionary:

public class HowToDictionaryInitializer
{
    class StudentName
    {
        public string? FirstName { get; set; }
        public string? LastName { get; set; }
        public int ID { get; set; }
    }

    public static void Main()
    {
        var students = new Dictionary<int, StudentName>()
        {
            { 111, new StudentName { FirstName="Sachin", LastName="Karnik", ID=211 } },
            { 112, new StudentName { FirstName="Dina", LastName="Salimzianova", ID=317 } },
            { 113, new StudentName { FirstName="Andy", LastName="Ruth", ID=198 } }
        };

        foreach(var index in Enumerable.Range(111, 3))
        {
            Console.WriteLine($"Student {index} is {students[index].FirstName} {students[index].LastName}");
        }
        Console.WriteLine();		

        var students2 = new Dictionary<int, StudentName>()
        {
            [111] = new StudentName { FirstName="Sachin", LastName="Karnik", ID=211 },
            [112] = new StudentName { FirstName="Dina", LastName="Salimzianova", ID=317 } ,
            [113] = new StudentName { FirstName="Andy", LastName="Ruth", ID=198 }
        };

        foreach (var index in Enumerable.Range(111, 3))
        {
            Console.WriteLine($"Student {index} is {students2[index].FirstName} {students2[index].LastName}");
        }
    }
}

Observe os dois pares de chaves em cada elemento da coleção na primeira declaração. As chaves mais internas incluem o inicializador do objeto para o StudentName, e as chaves mais externas incluem o inicializador do par chave/valor a ser adicionado ao studentsDictionary<TKey,TValue>. Por fim, todo o inicializador de coleção do dicionário é colocado entre chaves. Na segunda inicialização, o lado esquerdo da atribuição é a chave e o lado direito é o valor, usando um inicializador de objeto para StudentName.

Confira também