Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

List<T> — lista generyczna o zmiennym rozmiarze

List<T> z System.Collections.Generic przechowuje elementy określonego typu w uporządkowanej, modyfikowalnej kolekcji. Metoda Add dopisuje element na końcu, a właściwość Count podaje aktualną liczbę elementów, nie pojemność listy.

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

Składnia

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

List<T> z System.Collections.Generic to modyfikowalna lista oparta na tablicy, której pojemność rośnie w razie potrzeby. Parametr T określa typ elementów, np. List<string>. Lista dopuszcza duplikaty i nie sortuje elementów automatycznie. Indeksy zaczynają się od zera; poprawny zakres to 0 <= index < Count.

List<T>.Add(T item) dodaje jeden element na końcu i zwraca void. Po udanym dodaniu Count wzrasta o jeden. Gdy jest wolne miejsce, operacja ma koszt O(1); gdy trzeba powiększyć tablicę i skopiować elementy, koszt wynosi O(n), gdzie n to dotychczasowe Count.

List<T>.Count jest właściwością typu int tylko do odczytu, odczytywaną bez nawiasów: names.Count. Jej odczyt ma koszt O(1). Count oznacza liczbę zapisanych elementów, a Capacity — liczbę elementów mieszczących się bez powiększania tablicy. new List<string>(4) tworzy pustą listę z miejscem na cztery elementy; nie tworzy czterech elementów.

Przykład pokazuje pustą listę, trzy wywołania Add, duplikat i odczyt przez indeks. Użyte API są dostępne w .NET 10 i nie wymagają funkcji języka w wersji preview. Przy współdzieleniu listy między wątkami z modyfikacjami potrzebna jest synchronizacja; metody instancji nie gwarantują bezpieczeństwa wątkowego.

Przykłady

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));
    }
}

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła