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

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 é como as chaves duplicadas são tratadas, por exemplo:

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

Add o método lança ArgumentException: 'An item with the same key has already been added. Key: 111', enquanto a segunda parte do exemplo, o método de indexador de leitura/gravação público, sobrescreve 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 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.

Usar a IA para gerar dados de teste para coleções de dicionários

Você pode usar ferramentas de IA, como o GitHub Copilot, para gerar rapidamente dados de teste de dicionário e cenários de validação em seus projetos em C#.

Aqui está um exemplo de prompt que você pode usar no Visual Studio Copilot Chat.

Generate data collections for tests to create a separate Dictionary<int, Student> containing 10 valid Student records and 5 invalid records. 
- Valid records should have realistic Name and Grade values.
- Invalid records should include cases such as missing Name, Grade < 0, or Grade > 100. 
- This dictionary should be used only for testing purposes and not modify existing production code.
- Generate test code that utilizes this test data for validation scenarios.
- Call test method to run the test.

Examine as sugestões do Copilot antes de aplicá-las.

Para obter mais informações sobre o GitHub Copilot, consulte as perguntas frequentes do GitHub.

Confira também

• Inicializadores de objeto e coleção