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.