OrderedDictionary.Contains(Object) Methode

Definition

Namespace:

System.Collections.Specialized

Assemblys:

System.dll, System.Collections.Specialized.dll

Assembly:

System.Collections.Specialized.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Bestimmt, ob die OrderedDictionary-Auflistung einen bestimmten Schlüssel enthält.

public:
 virtual bool Contains(System::Object ^ key);

public bool Contains (object key);

abstract member Contains : obj -> bool
override this.Contains : obj -> bool

Public Function Contains (key As Object) As Boolean

Parameter

key

Object

Der in der OrderedDictionary-Auflistung zu suchende Schlüssel.

Gibt zurück

Boolean

true, wenn die OrderedDictionary-Auflistung ein Element mit dem angegebenen Schlüssel enthält, andernfalls false.

Implementiert

Contains(Object)

Beispiele

Im folgenden Codebeispiel wird die Änderung einer OrderedDictionary Auflistung veranschaulicht. In diesem Beispiel wird die Contains Methode verwendet, um festzustellen, ob ein Eintrag vorhanden ist, bevor versucht wird, ihn zu entfernen. Dieser Code ist Teil eines größeren Codebeispiels, das angezeigt OrderedDictionarywerden kann.

// Modifying the OrderedDictionary
if (!myOrderedDictionary->IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary->Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary->RemoveAt(myOrderedDictionary->Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary->Contains("keyToDelete"))
    {
        myOrderedDictionary->Remove("keyToDelete");
    }
}

// Modifying the OrderedDictionary
if (!myOrderedDictionary.IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary.Contains("keyToDelete"))
    {
        myOrderedDictionary.Remove("keyToDelete");
    }
}

' Modifying the OrderedDictionary
If Not myOrderedDictionary.IsReadOnly Then

    ' Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1")

    ' Modify the value of the entry with the key "testKey2"
    myOrderedDictionary("testKey2") = "modifiedValue"

    ' Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1)

    ' Remove the "keyToDelete" entry, if it exists
    If (myOrderedDictionary.Contains("keyToDelete")) Then
        myOrderedDictionary.Remove("keyToDelete")
    End If
End If

Hinweise

Die Verwendung der Item[] Eigenschaft kann einen NULL-Wert zurückgeben, wenn der Schlüssel nicht vorhanden ist oder der Schlüssel ist null. Verwenden Sie die Contains Methode, um zu ermitteln, ob ein bestimmter Schlüssel in der OrderedDictionary Auflistung vorhanden ist.

Ab dem .NET Framework 2.0 verwendet diese Methode die Objekte Equals und CompareTo Methoden item der Auflistung, um festzustellen, ob item vorhanden ist. In den früheren Versionen der .NET Framework wurde diese Bestimmung mithilfe Equals der Und CompareTo Methoden des item Parameters für die Objekte in der Auflistung vorgenommen.