Compartir a través de


OrderedDictionary.Add(Object, Object) Método

Definición

Agrega una entrada con la clave y el valor especificados a la colección OrderedDictionary, en el índice más bajo que esté disponible.

public:
 virtual 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
override this.Add : obj * obj -> unit
Public Sub Add (key As Object, value As Object)

Parámetros

key
Object

Clave de la entrada que se va a agregar.

value
Object

Valor de la entrada que se va a agregar. Este valor puede ser null.

Implementaciones

Excepciones

La colección OrderedDictionary es de sólo lectura.

Ya existe un elemento con la misma clave en la colección OrderedDictionary.

Ejemplos

En el ejemplo de código siguiente se muestra la creación y el rellenado de una OrderedDictionary colección. Este código forma parte de un ejemplo de código más grande que se puede ver en OrderedDictionary.

// Creates and initializes a OrderedDictionary.
OrderedDictionary^ myOrderedDictionary = gcnew OrderedDictionary();
myOrderedDictionary->Add("testKey1", "testValue1");
myOrderedDictionary->Add("testKey2", "testValue2");
myOrderedDictionary->Add("keyToDelete", "valueToDelete");
myOrderedDictionary->Add("testKey3", "testValue3");

ICollection^ keyCollection = myOrderedDictionary->Keys;
ICollection^ valueCollection = myOrderedDictionary->Values;

// Display the contents using the key and value collections
DisplayContents(keyCollection, valueCollection, myOrderedDictionary->Count);
// Creates and initializes a OrderedDictionary.
OrderedDictionary myOrderedDictionary = new OrderedDictionary();
myOrderedDictionary.Add("testKey1", "testValue1");
myOrderedDictionary.Add("testKey2", "testValue2");
myOrderedDictionary.Add("keyToDelete", "valueToDelete");
myOrderedDictionary.Add("testKey3", "testValue3");

ICollection keyCollection = myOrderedDictionary.Keys;
ICollection valueCollection = myOrderedDictionary.Values;

// Display the contents using the key and value collections
DisplayContents(keyCollection, valueCollection, myOrderedDictionary.Count);
' Creates and initializes a OrderedDictionary.
Dim myOrderedDictionary As New OrderedDictionary()
myOrderedDictionary.Add("testKey1", "testValue1")
myOrderedDictionary.Add("testKey2", "testValue2")
myOrderedDictionary.Add("keyToDelete", "valueToDelete")
myOrderedDictionary.Add("testKey3", "testValue3")

Dim keyCollection As ICollection = myOrderedDictionary.Keys
Dim valueCollection As ICollection = myOrderedDictionary.Values

' Display the contents Imports the key and value collections
DisplayContents( _
    keyCollection, valueCollection, myOrderedDictionary.Count)

Comentarios

Una clave no puede ser null, pero un valor puede ser .

También puede usar la Item[] propiedad para agregar nuevos elementos estableciendo el valor de una clave que no existe en la OrderedDictionary colección; sin embargo, si la clave especificada ya existe en , OrderedDictionaryal establecer la propiedad se Item[] sobrescribe el valor anterior. Por el contrario, el Add método no modifica los elementos existentes, sino que produce ArgumentException.

Se aplica a