War diese Seite hilfreich?
Ihr Feedback ist uns wichtig. Teilen Sie uns Ihre Meinung mit.
Weiteres Feedback?
1500 verbleibende Zeichen
Exportieren (0) Drucken
Alle erweitern

SortedDictionary.ContainsKey-Methode

Hinweis: Diese Methode ist neu in .NET Framework, Version 2.0.

Ermittelt, ob das SortedDictionary ein Element mit dem angegebenen Schlüssel enthält.

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

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

Parameter

key

Der im SortedDictionary zu suchende Schlüssel.

Rückgabewert

true, wenn das SortedDictionary ein Element mit dem angegebenen Schlüssel enthält, andernfalls false.

AusnahmetypBedingung

ArgumentNullException

key ist NULL (Nothing in Visual Basic).

Diese Methode ist ein O(log n)-Vorgang.

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 SortedDictionary-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 98, Windows 2000 SP4, Windows Millennium Edition, 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.

.NET Framework

Unterstützt in: 2.0
Anzeigen:
© 2015 Microsoft