Collection.Contains-Methode
Assembly: mscorlib (in mscorlib.dll)
public final boolean Contains ( T item )
public final function Contains ( item : T ) : boolean
Parameter
- item
Das im Collection zu suchende Objekt. Der Wert kann für Verweistypen NULL (Nothing in Visual Basic) sein.
Rückgabewert
true, wenn sich das item in der Collection befindet, andernfalls false.Diese Methode ermittelt die Gleichheit mithilfe des Standardcomparers Comparer.Default. Comparer.Default überprüft, ob der Typ T System.IComparable implementiert und verwendet diese Implementierung, sofern vorhanden. Andernfalls überprüft Comparer.Default, ob der Typ T System.IComparable implementiert. Wenn der Typ T keine der beiden Schnittstellen implementiert, verwendet diese Methode System.Object.Equals.
Diese Methode führt eine lineare Suche aus. Die durchschnittliche Ausführungszeit ist somit proportional zu Count. Das heißt, diese Methode ist ein O(n)-Vorgang, wobei n gleich Count ist.
Im folgenden Codebeispiel werden viele Eigenschaften und Methoden von Collection veranschaulicht. Im Codebeispiel wird eine Auflistung von Zeichenfolgen erstellt. Anschließend werden mit der Add-Methode mehrere Zeichenfolgen hinzugefügt, der Count angezeigt und die Zeichenfolgen aufgelistet. Im Beispiel wird mithilfe der IndexOf-Methode der Index einer Zeichenfolge gesucht und mithilfe der Contains-Methode geprüft, ob eine bestimmte Zeichenfolge in der Auflistung enthalten ist. Mit der Insert-Methode wird eine Zeichenfolge eingefügt, und unter Verwendung der Item-Standardeigenschaft (Indexer in C#) werden Zeichenfolgen abgerufen und festgelegt. Im Beispiel werden Zeichenfolgen anhand der Zeichenfolgenidentität unter Verwendung der Remove-Methode und anhand des Indexes unter Verwendung der RemoveAt-Methode entfernt. Abschließend werden mit der Clear-Methode alle Zeichenfolgen aus der Auflistung gelöscht.
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 */
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
