OrderedDictionary.Add(Object, Object) Metodo

Definizione

Spazio dei nomi:
System.Collections.Specialized
Assembly:
System.dll, System.Collections.Specialized.dll
Assembly:
netstandard.dll, System.Collections.Specialized.dll
Assembly:
System.Collections.Specialized.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origine:
OrderedDictionary.cs
Origine:
OrderedDictionary.cs
Origine:
OrderedDictionary.cs
Origine:
OrderedDictionary.cs
Origine:
OrderedDictionary.cs

Aggiunge una voce con la chiave e il valore specificati nella OrderedDictionary raccolta con l'indice più basso disponibile.

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)

Parametri

key
Object

Chiave della voce da aggiungere.

value
Object

Valore della voce da aggiungere. Il valore può essere null.

Implementazioni

Add(Object, Object)

Eccezioni

NotSupportedException

La OrderedDictionary raccolta è di sola lettura.

ArgumentException

Un elemento con la stessa chiave esiste già nella OrderedDictionary raccolta.

Esempio

Nell'esempio di codice seguente viene illustrata la creazione e il popolamento di una OrderedDictionary raccolta. Questo codice fa parte di un esempio di codice più ampio che può essere visualizzato in OrderedDictionary.

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

Commenti

Una chiave non può essere null, ma un valore può essere .

È anche possibile utilizzare la Item[] proprietà per aggiungere nuovi elementi impostando il valore di una chiave che non esiste nell'insieme OrderedDictionary . Se tuttavia la chiave specificata esiste già in , l'impostazione OrderedDictionarydella Item[] proprietà sovrascrive il valore precedente. Al contrario, il Add metodo non modifica gli elementi esistenti ma genera ArgumentExceptioninvece .

Si applica a