Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

List<T> — dinamični generični seznam

List<T> iz System.Collections.Generic shranjuje elemente določene vrste v urejeni, spremenljivi zbirki. Metoda Add doda element na konec, lastnost Count pa podaja trenutno število elementov, ne zmogljivosti seznama.

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

Sintaksa

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

List<T> iz System.Collections.Generic je spremenljiv seznam, temelječ na polju, katerega zmogljivost se po potrebi poveča. Parameter T določa vrsto elementov, na primer List<string>. Seznam dopušča dvojnike in elementov ne razvršča samodejno. Indeksi se začnejo z nič; veljavno območje je 0 <= index < Count.

List<T>.Add(T item) doda en element na konec in vrne void. Po uspešnem dodajanju se Count poveča za ena. Če je na voljo dovolj prostora, ima operacija zahtevnost O(1); če je treba povečati polje in kopirati obstoječe elemente, je zahtevnost O(n), pri čemer je n prejšnja vrednost Count.

List<T>.Count je lastnost vrste int, namenjena samo branju; dostopamo do nje brez oklepajev: names.Count. Branje ima zahtevnost O(1). Count pomeni število shranjenih elementov, Capacity pa število elementov, ki se prilegajo brez povečanja polja. new List<string>(4) ustvari prazen seznam s prostorom za štiri elemente; ne ustvari štirih elementov.

Primer prikazuje prazen seznam, tri klice Add, dvojnik in dostop z indeksom. Ti API-ji so na voljo v .NET 10 in ne zahtevajo jezikovnih funkcij v predogledni različici. Če seznam spreminjamo in ga uporablja več niti, je potrebna sinhronizacija; člani primerka ne zagotavljajo varnosti pri uporabi več niti.

Primeri

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

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri