Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje