PropertyCollection.IDictionary.Add(Object, Object) Método

Definição

Adiciona um elemento com a chave e o valor fornecidos ao objeto IDictionary.Adds an element with the provided key and value to the IDictionary object.

 virtual void System.Collections.IDictionary.Add(System::Object ^ key, System::Object ^ value) = System::Collections::IDictionary::Add;
void IDictionary.Add (object key, object value);
abstract member System.Collections.IDictionary.Add : obj * obj -> unit
override this.System.Collections.IDictionary.Add : obj * obj -> unit
Sub Add (key As Object, value As Object) Implements IDictionary.Add

Parâmetros

key
Object

O Object a ser usado como chave do elemento a ser adicionado.The Object to use as the key of the element to add.

value
Object

O Object a ser usado como valor do elemento a ser adicionado.The Object to use as the value of the element to add.

Implementações

Exceções

key é null.key is null.

Já existe um elemento com a mesma chave no objeto IDictionary.An element with the same key already exists in the IDictionary object.

O IDictionary é somente leitura.The IDictionary is read-only.

-ou--or- O IDictionary tem um tamanho fixo.The IDictionary has a fixed size.

Exemplos

O exemplo a seguir mostra como implementar o método Add.The following example shows how to implement the Add method. Este exemplo de código faz parte de um exemplo maior fornecido para a classe IDictionary.This code example is part of a larger example provided for the IDictionary class.

public:
    virtual void Add(Object^ key, Object^ value)
    {
        // Add the new key/value pair even if this key already exists
        // in the dictionary.
        if (itemsInUse == items->Length)
        {
            throw gcnew InvalidOperationException
                ("The dictionary cannot hold any more items.");
        }
        items[itemsInUse++] = gcnew DictionaryEntry(key, value);
    }
public void Add(object key, object value) 
{
    // Add the new key/value pair even if this key already exists in the dictionary.
    if (ItemsInUse == items.Length)
        throw new InvalidOperationException("The dictionary cannot hold any more items.");
    items[ItemsInUse++] = new DictionaryEntry(key, value);
}
Public Sub Add(ByVal key As Object, ByVal value As Object) Implements IDictionary.Add

    ' Add the new key/value pair even if this key already exists in the dictionary.
    If ItemsInUse = items.Length Then
        Throw New InvalidOperationException("The dictionary cannot hold any more items.")
    End If
    items(ItemsInUse) = New DictionaryEntry(key, value)
    ItemsInUse = ItemsInUse + 1
End Sub

Comentários

Você também pode usar a propriedade Item[Object] para adicionar novos elementos definindo o valor de uma chave que não existe no dicionário (por exemplo, myCollection["myNonexistentKey"] = myValue).You can also use the Item[Object] property to add new elements by setting the value of a key that does not exist in the dictionary (for example, myCollection["myNonexistentKey"] = myValue). No entanto, se a chave especificada já existir no dicionário, a definição da propriedade Item[Object] substituirá o valor antigo.However, if the specified key already exists in the dictionary, setting the Item[Object] property overwrites the old value. Por outro lado, o método Add não modifica os elementos existentes.In contrast, the Add method does not modify existing elements.

Aplica-se a

Veja também