IDictionary.Add(Object, Object) Método

Definição

Espaço de Nomes:
System.Collections
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
netstandard.dll

Adiciona um elemento com a chave e o valor fornecidos ao IDictionary objeto.

public:
 void Add(System::Object ^ key, System::Object ^ value);
public void Add(object key, object value);
abstract member Add : obj * obj -> unit
Public Sub Add (key As Object, value As Object)

Parâmetros

key
Object

O Object to use como a chave do elemento a adicionar.

value
Object

O Object to use como valor do elemento a adicionar.

Exceções

ArgumentNullException

key é null.

ArgumentException

Um elemento com a mesma chave já existe no IDictionary objeto.

NotSupportedException

É IDictionary só de leitura.

-ou-

Tem IDictionary um tamanho fixo.

Exemplos

O exemplo de código seguinte demonstra como implementar o Add método. Este exemplo de código faz parte de um exemplo maior fornecido para a IDictionary classe.

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

Observações

Também pode usar a Item[] propriedade para adicionar novos elementos definindo o valor de uma chave que não existe no dicionário (por exemplo, myCollection["myNonexistentKey"] = myValue). No entanto, se a chave especificada já existir no dicionário, definir a Item[] propriedade sobrescreve o valor antigo. Em contraste, o Add método não modifica elementos existentes.

As implementações podem variar quanto a permitir que a chave seja null.

Aplica-se a

Ver também