SortedDictionary<TKey,TValue>.Add(TKey, TValue) SortedDictionary<TKey,TValue>.Add(TKey, TValue) SortedDictionary<TKey,TValue>.Add(TKey, TValue) SortedDictionary<TKey,TValue>.Add(TKey, TValue) Method

Definição

Adiciona um elemento com a chave e o valor especificados ao SortedDictionary<TKey,TValue>.Adds an element with the specified key and value into the SortedDictionary<TKey,TValue>.

public:
 virtual void Add(TKey key, TValue value);
public void Add (TKey key, TValue value);
abstract member Add : 'Key * 'Value -> unit
override this.Add : 'Key * 'Value -> unit
Public Sub Add (key As TKey, value As TValue)

Parâmetros

key
TKey TKey TKey TKey

A chave do elemento a ser adicionada.The key of the element to add.

value
TValue TValue TValue TValue

O valor do elemento a ser adicionado.The value of the element to add. O valor pode ser null para tipos de referência.The value can be null for reference types.

Implementações

Exceções

Já existe um elemento com a mesma chave no SortedDictionary<TKey,TValue>.An element with the same key already exists in the SortedDictionary<TKey,TValue>.

Exemplos

O exemplo de código a seguir cria SortedDictionary<TKey,TValue> uma cadeia de caracteres vazia com chaves de Add cadeia de caracteres e usa o método para adicionar alguns elementos.The following code example creates an empty SortedDictionary<TKey,TValue> of strings with string keys and uses the Add method to add some elements. O exemplo demonstra que o Add método gera um ArgumentException ao tentar adicionar uma chave duplicada.The example demonstrates that the Add method throws an ArgumentException when attempting to add a duplicate key.

Este exemplo de código faz parte de um exemplo maior fornecido para SortedDictionary<TKey,TValue> a classe.This code example is part of a larger example provided for the SortedDictionary<TKey,TValue> class.

// Create a new sorted dictionary of strings, with string
// keys.
SortedDictionary<string, string> openWith = 
    new SortedDictionary<string, string>();

// Add some elements to the dictionary. There are no 
// duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe");
openWith.Add("bmp", "paint.exe");
openWith.Add("dib", "paint.exe");
openWith.Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is 
// already in the dictionary.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}
' Create a new sorted dictionary of strings, with string 
' keys. 
Dim openWith As New SortedDictionary(Of String, String)

' Add some elements to the dictionary. There are no 
' duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe")
openWith.Add("bmp", "paint.exe")
openWith.Add("dib", "paint.exe")
openWith.Add("rtf", "wordpad.exe")

' The Add method throws an exception if the new key is 
' already in the dictionary.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt"" already exists.")
End Try

Comentários

Você também pode usar a Item[TKey] propriedade para adicionar novos elementos definindo o valor de uma chave que não existe SortedDictionary<TKey,TValue>no; por exemplo, myCollection["myNonexistentKey"] = myValue (em Visual Basic, myCollection("myNonexistantKey") = myValue).You can also use the Item[TKey] property to add new elements by setting the value of a key that does not exist in the SortedDictionary<TKey,TValue>; for example, myCollection["myNonexistentKey"] = myValue (in Visual Basic, myCollection("myNonexistantKey") = myValue). No entanto, se a chave especificada já existir SortedDictionary<TKey,TValue>no, definir Item[TKey] a propriedade substituirá o valor antigo.However, if the specified key already exists in the SortedDictionary<TKey,TValue>, setting the Item[TKey] property overwrites the old value. Por outro lado, Add o método lançará uma exceção se um elemento com a chave especificada já existir.In contrast, the Add method throws an exception if an element with the specified key already exists.

Uma chave não pode nullser, mas um valor pode ser, se o tipo TValue de valor for um tipo de referência.A key cannot be null, but a value can be, if the value type TValue is a reference type.

Este método é uma operação O(log n), em que n é Count.This method is an O(log n) operation, where n is Count.

Aplica-se a

Veja também