SortedList<TKey,TValue>.Add(TKey, TValue) Método

Definición

Espacio de nombres:

System.Collections.Generic

Ensamblado:

System.Collections.dll

Source:

SortedList.cs

Agrega un elemento con la clave y el valor especificados a SortedList<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

Clave del elemento que se va a agregar.

value

TValue

Valor del elemento que se va a agregar. El valor puede ser null para los tipos de referencia.

Implementaciones

Add(TKey, TValue)

Excepciones

ArgumentNullException

key es null.

ArgumentException

Ya existe un elemento con la misma clave en SortedList<TKey,TValue>.

Ejemplos

En el ejemplo de código siguiente se crea un vacío SortedList<TKey,TValue> de cadenas con claves de cadena y se usa el Add método para agregar algunos elementos. En el ejemplo se muestra que el Add método produce un ArgumentException al intentar agregar una clave duplicada.

Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase SortedList<TKey,TValue>.

// Create a new sorted list of strings, with string
// keys.
SortedList<String^, String^>^ openWith =
    gcnew SortedList<String^, String^>();

// Add some elements to the list. 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 list.
try
{
    openWith->Add("txt", "winword.exe");
}
catch (ArgumentException^)
{
    Console::WriteLine("An element with Key = \"txt\" already exists.");
}

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

// Add some elements to the list. 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 list.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}

' Create a new sorted list of strings, with string 
' keys. 
Dim openWith As New SortedList(Of String, String)

' Add some elements to the list. 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 list.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt"" already exists.")
End Try

// Create a new sorted list of strings, with string
// keys.
let openWith = SortedList<string, string>()

// Add some elements to the list. 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 list.
try
    openWith.Add("txt", "winword.exe");
with
    | :? ArgumentException ->
        printfn "An element with Key = \"txt\" already exists."

Comentarios

Una clave no puede ser null, pero un valor puede ser, si el tipo de valores de la lista ordenada, TValue, es un tipo de referencia.

También puede usar la Item[] propiedad para agregar nuevos elementos estableciendo el valor de una clave que no existe en SortedList<TKey,TValue>; por ejemplo, myCollection["myNonexistentKey"] = myValue. Sin embargo, si la clave especificada ya existe en SortedList<TKey,TValue>, al establecer la propiedad se Item[] sobrescribe el valor anterior. En cambio, el Add método no modifica los elementos existentes.

Si Count ya es Capacityigual a , la capacidad de se incrementa mediante la reasignación automática de SortedList<TKey,TValue> la matriz interna y los elementos existentes se copian en la nueva matriz antes de agregar el nuevo elemento.

Este método es una operación de O(n) para datos no ordenados, donde n es Count. Se trata de una operación O(log n) si el nuevo elemento se agrega al final de la lista. Si la inserción produce un cambio de tamaño, la operación es O(n).

Consulte también

• Remove(TKey)
• Item[TKey]
• Add(TKey, TValue)