OrderedDictionary.Add(Object, Object) Método

Definición

Espacio de nombres:

System.Collections.Specialized

Ensamblado:

System.Collections.Specialized.dll

Source:

OrderedDictionary.cs

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);

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

Add(Object, Object)

Excepciones

NotSupportedException

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

ArgumentException

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.