List<T>.Clear Methode

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Quelle:

List.cs

Entfernt alle Elemente aus der List<T>.

C#

public void Clear ();

Implementiert

Clear() Clear()

Beispiele

Im folgenden Beispiel wird die Clear -Methode und verschiedene andere Eigenschaften und Methoden der List<T> generischen Klasse veranschaulicht. Die Clear -Methode wird am Ende des Programms verwendet, um alle Elemente aus der Liste zu entfernen, und die Capacity Eigenschaften und Count werden dann angezeigt.

C#

List<string> dinosaurs = new List<string>();

Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);

dinosaurs.Add("Tyrannosaurus");
dinosaurs.Add("Amargasaurus");
dinosaurs.Add("Mamenchisaurus");
dinosaurs.Add("Deinonychus");
dinosaurs.Add("Compsognathus");
Console.WriteLine();
foreach(string dinosaur in dinosaurs)
{
    Console.WriteLine(dinosaur);
}

Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);
Console.WriteLine("Count: {0}", dinosaurs.Count);

Console.WriteLine("\nContains(\"Deinonychus\"): {0}",
    dinosaurs.Contains("Deinonychus"));

Console.WriteLine("\nInsert(2, \"Compsognathus\")");
dinosaurs.Insert(2, "Compsognathus");

Console.WriteLine();
foreach(string dinosaur in dinosaurs)
{
    Console.WriteLine(dinosaur);
}

// Shows accessing the list using the Item property.
Console.WriteLine("\ndinosaurs[3]: {0}", dinosaurs[3]);

Console.WriteLine("\nRemove(\"Compsognathus\")");
dinosaurs.Remove("Compsognathus");

Console.WriteLine();
foreach(string dinosaur in dinosaurs)
{
    Console.WriteLine(dinosaur);
}

dinosaurs.TrimExcess();
Console.WriteLine("\nTrimExcess()");
Console.WriteLine("Capacity: {0}", dinosaurs.Capacity);
Console.WriteLine("Count: {0}", dinosaurs.Count);

dinosaurs.Clear();
Console.WriteLine("\nClear()");
Console.WriteLine("Capacity: {0}", dinosaurs.Capacity);
Console.WriteLine("Count: {0}", dinosaurs.Count);

/* This code example produces the following output:

Capacity: 0

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Deinonychus
Compsognathus

Capacity: 8
Count: 5

Contains("Deinonychus"): True

Insert(2, "Compsognathus")

Tyrannosaurus
Amargasaurus
Compsognathus
Mamenchisaurus
Deinonychus
Compsognathus

dinosaurs[3]: Mamenchisaurus

Remove("Compsognathus")

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Deinonychus
Compsognathus

TrimExcess()
Capacity: 5
Count: 5

Clear()
Capacity: 5
Count: 0
 */

Hinweise

Count ist auf 0 festgelegt, und Verweise auf andere Objekte aus Elementen der Auflistung werden ebenfalls freigegeben.

Capacity bleibt unverändert. Um die Kapazität von List<T>zurückzusetzen, rufen Sie die TrimExcess -Methode auf, oder legen Sie die Capacity -Eigenschaft direkt fest. Durch das Verringern der Kapazität wird arbeitsspeicher neu zugewiesen und alle Elemente in kopiert List<T>. Durch Das Kürzen eines leeren List<T> Wird die Kapazität von List<T> auf die Standardkapazität festgelegt.

Bei dieser Methode handelt es sich um einen O(n)-Vorgang, wobei n ist Count.

Gilt für:

Weitere Informationen

• TrimExcess()
• Capacity
• Count