CKTIS / C#
List<T> — dynamický generický seznam
List<T> z System.Collections.Generic ukládá prvky určeného typu do uspořádané, měnitelné kolekce. Metoda Add přidává prvek na konec, zatímco vlastnost Count udává aktuální počet prvků, nikoli kapacitu seznamu.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
List<T> items = new List<T>();
items.Add(value);
int count = items.Count;
T first = items[0];List<T> z System.Collections.Generic je měnitelný seznam založený na poli, jehož kapacita se podle potřeby zvětšuje. Parametr T určuje typ prvků, například List<string>. Seznam umožňuje duplicity a prvky automaticky netřídí. Indexy začínají nulou; platný rozsah je 0 <= index < Count.
List<T>.Add(T item) přidá jeden prvek na konec a vrací void. Po úspěšném přidání se Count zvýší o jedna. Pokud je k dispozici volná kapacita, má operace složitost O(1); pokud je nutné pole zvětšit a zkopírovat stávající prvky, má složitost O(n), kde n je předchozí hodnota Count.
List<T>.Count je vlastnost typu int určená pouze ke čtení, přistupuje se k ní bez závorek: names.Count. Její čtení má složitost O(1). Count znamená počet uložených prvků, zatímco Capacity označuje počet prvků, které se vejdou bez zvětšení pole. new List<string>(4) vytvoří prázdný seznam s místem pro čtyři prvky; nevytvoří čtyři prvky.
Příklad ukazuje prázdný seznam, tři volání Add, duplicitu a přístup pomocí indexu. Tato API jsou dostupná v .NET 10 a nevyžadují funkce jazyka ve verzi preview. Pokud je seznam sdílen mezi vlákny a upravován, je nutná synchronizace; členy instance nezaručují bezpečnost vláken.
Příklady
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));
}
}Výsledek
Count: 0 Count: 3 First: Ada Ada, Linus, Ada
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.