(0) exportieren Drucken
Alle erweitern

Dictionary<TKey, TValue>.ContainsKey-Methode

Aktualisiert: November 2007

Bestimmt, ob das Dictionary<TKey, TValue> den angegebenen Schlüssel enthält.

Namespace:  System.Collections.Generic
Assembly:  mscorlib (in mscorlib.dll)

public bool ContainsKey(
	TKey key
)
public final boolean ContainsKey(
	TKey key
)
public final function ContainsKey(
	key : TKey
) : boolean

Parameter

key
Typ: TKey
Der im Dictionary<TKey, TValue> zu suchende Schlüssel.

Rückgabewert

Typ: System.Boolean
true, wenn das Dictionary<TKey, TValue> ein Element mit dem angegebenen Schlüssel enthält, andernfalls false.

Implementiert

IDictionary<TKey, TValue>.ContainsKey(TKey)

AusnahmeBedingung
ArgumentNullException

Der key-Parameter ist null.

Diese Methode kommt einem O(1)-Vorgang nahe.

Im folgenden Codebeispiel wird veranschaulicht, wie vor dem Aufrufen der Add-Methode mithilfe der ContainsKey-Methode überprüft wird, ob ein Schlüssel vorhanden ist. Außerdem wird das Abrufen von Werten mithilfe der TryGetValue-Methode veranschaulicht. Wenn ein Programm häufig versucht, auf Werte zuzugreifen, die nicht im Wörterbuch enthalten sind, lassen sich Werte auf diese Weise effizienter abrufen. Abschließend wird mit der Item-Eigenschaft (Indexer in C#) die am wenigsten effiziente Methode zum Testen des Vorhandenseins von Schlüsseln gezeigt.

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die Dictionary<TKey, TValue>-Klasse.

// ContainsKey can be used to test keys before inserting 
// them.
if (!openWith.ContainsKey("ht"))
{
    openWith.Add("ht", "hypertrm.exe");
    Console.WriteLine("Value added for key = \"ht\": {0}", 
        openWith["ht"]);
}


...


// When a program often has to try keys that turn out not to
// be in the dictionary, TryGetValue can be a more efficient 
// way to retrieve values.
string value = "";
if (openWith.TryGetValue("tif", out value))
{
    Console.WriteLine("For key = \"tif\", value = {0}.", value);
}
else
{
    Console.WriteLine("Key = \"tif\" is not found.");
}


...


// The indexer throws an exception if the requested key is
// not in the dictionary.
try
{
    Console.WriteLine("For key = \"tif\", value = {0}.", 
        openWith["tif"]);
}
catch (KeyNotFoundException)
{
    Console.WriteLine("Key = \"tif\" is not found.");
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC, Xbox 360

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0

.NET Compact Framework

Unterstützt in: 3.5, 2.0

XNA Framework

Unterstützt in: 2.0, 1.0

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft