Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

List<T> — uma lista genérica redimensionável

List<T> de System.Collections.Generic armazena elementos de um tipo especificado numa coleção ordenada e modificável. O método Add acrescenta um elemento no final, enquanto a propriedade Count indica o número atual de elementos, não a capacidade da lista.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

List<T> items = new List<T>();
items.Add(value);
int count = items.Count;
T first = items[0];

List<T> de System.Collections.Generic é uma lista modificável baseada num array, cuja capacidade aumenta quando necessário. O parâmetro T especifica o tipo dos elementos, por exemplo, List<string>. A lista permite duplicados e não ordena automaticamente os elementos. Os índices começam em zero; o intervalo válido é 0 <= index < Count.

List<T>.Add(T item) acrescenta um elemento no final e devolve void. Após uma adição bem-sucedida, Count aumenta uma unidade. Se houver capacidade disponível, a operação tem um custo O(1); quando é necessário aumentar o array e copiar os elementos existentes, o custo é O(n), em que n corresponde ao valor anterior de Count.

List<T>.Count é uma propriedade int só de leitura, acedida sem parênteses: names.Count. A sua leitura tem um custo O(1). Count indica o número de elementos armazenados, enquanto Capacity indica quantos elementos cabem sem aumentar o array. new List<string>(4) cria uma lista vazia com espaço para quatro elementos; não cria quatro elementos.

O exemplo mostra uma lista vazia, três chamadas a Add, um duplicado e o acesso por índice. Estas API estão disponíveis no .NET 10 e não exigem funcionalidades da linguagem em pré-visualização. Se uma lista for partilhada entre threads e modificada, é necessária sincronização; os membros de instância não garantem segurança entre threads.

Exemplos

using System;
using System.Collections.Generic;

internal static class Program
{
    private static void Main()
    {
        List<string> names = new List<string>(4);
        Console.WriteLine($"Count: {names.Count}");

        names.Add("Ada");
        names.Add("Linus");
        names.Add("Ada");

        Console.WriteLine($"Count: {names.Count}");
        Console.WriteLine($"First: {names[0]}");
        Console.WriteLine(string.Join(", ", names));
    }
}

Resultado

Count: 0
Count: 3
First: Ada
Ada, Linus, Ada

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes