OrderedDictionary.Contains(Object) Método

Definição

Namespace:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Origem:

OrderedDictionary.cs

Determina se a coleção OrderedDictionary contém uma chave específica.

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

Parâmetros

key

Object

A chave a localizar na coleção OrderedDictionary.

Retornos

Boolean

true se a coleção OrderedDictionary contiver um elemento com a chave especificada; caso contrário, false.

Implementações

Contains(Object)

Exemplos

O exemplo de código a seguir demonstra a modificação de uma coleção OrderedDictionary . Neste exemplo, o Contains método é usado para determinar se existe uma entrada antes de tentar removê-la. Esse código faz parte de um exemplo de código maior que pode ser exibido em OrderedDictionary.

// 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

Comentários

Usar a Item[] propriedade poderá retornar um valor nulo se a chave não existir ou se a chave for null. Use o Contains método para determinar se existe uma chave específica na OrderedDictionary coleção.

A partir do .NET Framework 2.0, esse método usa os métodos e CompareTo objetos Equals da coleção em item para determinar se item existe. Em versões anteriores do .NET Framework, essa decisão era tomada usando-se os métodos Equals e CompareTo do parâmetro item nos objetos na coleção.