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

Definición

Agrega un elemento con la clave y el valor especificados a SortedList<TKey,TValue>.Adds an element with the specified key and value into the 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 TKey TKey TKey

Clave del elemento que se va a agregar.The key of the element to add.

value
TValue TValue TValue TValue

Valor del elemento que se va a agregar.The value of the element to add. El valor puede ser null para los tipos de referencia.The value can be null for reference types.

Implementaciones

Excepciones

Ya existe un elemento con la misma clave en SortedList<TKey,TValue>.An element with the same key already exists in the SortedList<TKey,TValue>.

Ejemplos

En el ejemplo de código siguiente se SortedList<TKey,TValue> crea un vacío de cadenas con claves de Add cadena y se usa el método para agregar algunos elementos.The following code example creates an empty SortedList<TKey,TValue> of strings with string keys and uses the Add method to add some elements. En el ejemplo se muestra Add que el método produce ArgumentException una excepción al intentar agregar una clave duplicada.The example demonstrates that the Add method throws an ArgumentException when attempting to add a duplicate key.

Este ejemplo de código forma parte de un ejemplo más extenso proporcionado SortedList<TKey,TValue> para la clase.This code example is part of a larger example provided for the SortedList<TKey,TValue> class.

// 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

Comentarios

Una clave no puede nullser, pero un valor puede ser, si el tipo de valores de la lista ordenada, TValue, es un tipo de referencia.A key cannot be null, but a value can be, if the type of values in the sorted list, TValue, is a reference type.

También puede usar la Item[TKey] propiedad para agregar nuevos elementos estableciendo el valor de una clave que no existe SortedList<TKey,TValue>en; por ejemplo, myCollection["myNonexistentKey"] = 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 SortedList<TKey,TValue>; for example, myCollection["myNonexistentKey"] = myValue. Sin embargo, si la clave especificada ya existe en SortedList<TKey,TValue>, al establecer Item[TKey] la propiedad se sobrescribe el valor anterior.However, if the specified key already exists in the SortedList<TKey,TValue>, setting the Item[TKey] property overwrites the old value. En cambio, el Add método no modifica los elementos existentes.In contrast, the Add method does not modify existing elements.

Si Count SortedList<TKey,TValue> yaCapacityes igual a, se aumenta la capacidad de la reasignación automática de la matriz interna y los elementos existentes se copian en la nueva matriz antes de agregar el nuevo elemento.If Count already equals Capacity, the capacity of the SortedList<TKey,TValue> is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

Este método es una operación On() para datos no ordenados, donde n es Count.This method is an O(n) operation for unsorted data, where n is Count. Es una operación O (log n) si el nuevo elemento se agrega al final de la lista.It is an O(log n) operation if the new element is added at the end of the list. Si la inserción provoca un redimensionamiento, la operación esnO ().If insertion causes a resize, the operation is O(n).

Se aplica a

Consulte también: