WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

List<T> — eine dynamische generische Liste

List<T> aus System.Collections.Generic speichert Elemente eines festgelegten Typs in einer geordneten, veränderbaren Sammlung. Add fügt ein Element am Ende hinzu, während Count die aktuelle Anzahl der Elemente angibt, nicht die Kapazität der Liste.

Version: .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> aus System.Collections.Generic ist eine veränderbare, arraybasierte Liste, deren Kapazität bei Bedarf wächst. Der Typparameter T legt den Elementtyp fest, zum Beispiel List<string>. Die Liste erlaubt Duplikate und sortiert Elemente nicht automatisch. Indizes beginnen bei null; der gültige Bereich ist 0 <= index < Count.

List<T>.Add(T item) fügt ein Element am Ende hinzu und gibt void zurück. Nach erfolgreichem Hinzufügen erhöht sich Count um eins. Bei freier Kapazität hat der Vorgang die Kosten O(1); muss das Array vergrößert und müssen vorhandene Elemente kopiert werden, betragen die Kosten O(n), wobei n dem vorherigen Count entspricht.

List<T>.Count ist eine schreibgeschützte int-Eigenschaft, auf die ohne Klammern zugegriffen wird: names.Count. Das Auslesen kostet O(1). Count bezeichnet die Anzahl gespeicherter Elemente, während Capacity die Anzahl angibt, die ohne Vergrößerung des Arrays hineinpasst. new List<string>(4) erstellt eine leere Liste mit Platz für vier Elemente; es erstellt nicht vier Elemente.

Das Beispiel zeigt eine leere Liste, drei Aufrufe von Add, ein Duplikat und den Zugriff über einen Index. Diese APIs sind in .NET 10 verfügbar und benötigen keine Preview-Sprachfunktionen. Wird eine Liste von mehreren Threads gemeinsam verwendet und verändert, ist Synchronisierung erforderlich; Instanzmember garantieren keine Thread-Sicherheit.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen