OrderedDictionary.Add(Object, Object) Metod

Definition

Namnområde:
System.Collections.Specialized
Sammansättningar:
System.dll, System.Collections.Specialized.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Lägger till en post med den angivna nyckeln och värdet i OrderedDictionary samlingen med det lägsta tillgängliga indexet.

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)

Parametrar

key
Object

Nyckeln för posten som ska läggas till.

value
Object

Värdet för posten som ska läggas till. Det här värdet kan vara null.

Implementeringar

Add(Object, Object)

Undantag

NotSupportedException

Samlingen OrderedDictionary är skrivskyddad.

ArgumentException

Det finns redan ett element med samma nyckel i OrderedDictionary samlingen.

Exempel

I följande kodexempel visas hur en OrderedDictionary samling skapas och populationen skapas. Den här koden är en del av ett större kodexempel som kan visas på 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)

Kommentarer

En nyckel kan inte vara null, men ett värde kan vara.

Du kan också använda Item[] egenskapen för att lägga till nya element genom att ange värdet för en nyckel som inte finns i OrderedDictionary samlingen. Men om den angivna nyckeln redan finns i OrderedDictionaryItem[] , skriver egenskapen över det gamla värdet. Metoden ändrar däremot inte befintliga element utan Add genererar ArgumentExceptioni stället .

Gäller för