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.
public:
void Add(System::Object ^ key, System::Object ^ value);
public void Add (object key, 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 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.
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 de código a seguir demonstra como implementar o Add método.The following code example demonstrates how to implement the Add method. Este exemplo de código faz parte de um exemplo maior fornecido para a IDictionary classe.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 Item[] propriedade 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[] 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, definir a Item[] Propriedade substituirá o valor antigo.However, if the specified key already exists in the dictionary, setting the Item[] property overwrites the old value. Por outro lado, o Add método não modifica os elementos existentes.In contrast, the Add method does not modify existing elements.
As implementações podem variar se permitirem que a chave seja null .Implementations can vary in whether they allow the key to be null.