KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

List<T> — een dynamische generieke lijst

List<T> uit System.Collections.Generic slaat elementen van een opgegeven type op in een geordende, wijzigbare verzameling. De methode Add voegt achteraan een element toe, terwijl de eigenschap Count het huidige aantal elementen weergeeft, niet de capaciteit van de lijst.

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

Syntax

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

List<T> uit System.Collections.Generic is een wijzigbare lijst op basis van een array, waarvan de capaciteit indien nodig groeit. De parameter T bepaalt het elementtype, bijvoorbeeld List<string>. De lijst staat duplicaten toe en sorteert elementen niet automatisch. Indexen beginnen bij nul; het geldige bereik is 0 <= index < Count.

List<T>.Add(T item) voegt één element achteraan toe en retourneert void. Na een geslaagde toevoeging neemt Count met één toe. Is er vrije capaciteit, dan kost de bewerking O(1); moet de array groter worden en moeten bestaande elementen worden gekopieerd, dan kost ze O(n), waarbij n de vorige waarde van Count is.

List<T>.Count is een alleen-lezen-eigenschap van het type int, die zonder haakjes wordt gebruikt: names.Count. Uitlezen kost O(1). Count is het aantal opgeslagen elementen; Capacity is het aantal elementen dat past zonder de array te vergroten. new List<string>(4) maakt een lege lijst met ruimte voor vier elementen; het maakt niet vier elementen.

Het voorbeeld laat een lege lijst, drie aanroepen van Add, een duplicaat en toegang via een index zien. Deze API’s zijn beschikbaar in .NET 10 en vereisen geen previewtaalfuncties. Als een lijst door meerdere threads wordt gedeeld en gewijzigd, is synchronisatie nodig; instantiemembers garanderen geen threadveiligheid.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen