Collection<T>.Clear Methode

Definition

Namespace:

System.Collections.ObjectModel

Assembly:

System.Runtime.dll

Quelle:

Collection.cs

Entfernt alle Elemente aus der Collection<T>.

C#

public void Clear ();

Implementiert

Clear() Clear()

Beispiele

Im folgenden Codebeispiel werden viele der Eigenschaften und Methoden von Collection<T>veranschaulicht. Im Codebeispiel wird eine Auflistung von Zeichenfolgen erstellt, die Add -Methode verwendet, um mehrere Zeichenfolgen hinzuzufügen, zeigt an Count, und listet die Zeichenfolgen auf. Im Beispiel wird die IndexOf -Methode verwendet, um den Index einer Zeichenfolge zu suchen, und die Contains -Methode, um zu bestimmen, ob eine Zeichenfolge in der Auflistung enthalten ist. Im Beispiel wird eine Zeichenfolge mithilfe der Insert -Methode eingefügt und Zeichenfolgen mithilfe der Standardeigenschaft Item[] (dem Indexer in C#) abgerufen und festgelegt. Im Beispiel werden Zeichenfolgen anhand der Zeichenfolgenidentität mithilfe der Remove -Methode und mithilfe der RemoveAt -Methode nach Index entfernt. Schließlich wird die Clear -Methode verwendet, um alle Zeichenfolgen aus der Auflistung zu löschen.

C#

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;

public class Demo
{
    public static void Main()
    {
        Collection<string> dinosaurs = new Collection<string>();

        dinosaurs.Add("Psitticosaurus");
        dinosaurs.Add("Caudipteryx");
        dinosaurs.Add("Compsognathus");
        dinosaurs.Add("Muttaburrasaurus");

        Console.WriteLine("{0} dinosaurs:", dinosaurs.Count);
        Display(dinosaurs);

        Console.WriteLine("\nIndexOf(\"Muttaburrasaurus\"): {0}",
            dinosaurs.IndexOf("Muttaburrasaurus"));

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

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

        Console.WriteLine("\ndinosaurs[2]: {0}", dinosaurs[2]);

        Console.WriteLine("\ndinosaurs[2] = \"Microraptor\"");
        dinosaurs[2] = "Microraptor";
        Display(dinosaurs);

        Console.WriteLine("\nRemove(\"Microraptor\")");
        dinosaurs.Remove("Microraptor");
        Display(dinosaurs);

        Console.WriteLine("\nRemoveAt(0)");
        dinosaurs.RemoveAt(0);
        Display(dinosaurs);

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

    private static void Display(Collection<string> cs)
    {
        Console.WriteLine();
        foreach( string item in cs )
        {
            Console.WriteLine(item);
        }
    }
}

/* This code example produces the following output:

4 dinosaurs:

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

IndexOf("Muttaburrasaurus"): 3

Contains("Caudipteryx"): True

Insert(2, "Nanotyrannus")

Psitticosaurus
Caudipteryx
Nanotyrannus
Compsognathus
Muttaburrasaurus

dinosaurs[2]: Nanotyrannus

dinosaurs[2] = "Microraptor"

Psitticosaurus
Caudipteryx
Microraptor
Compsognathus
Muttaburrasaurus

Remove("Microraptor")

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

RemoveAt(0)

Caudipteryx
Compsognathus
Muttaburrasaurus

dinosaurs.Clear()
Count: 0
 */

Hinweise

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

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

Hinweise für Vererber

Abgeleitete Klassen können überschreiben ClearItems() , um das Verhalten dieser Methode zu ändern.

Gilt für:

Weitere Informationen

• Count