OrderedDictionary.Add(Object, Object) Metoda

Reference

Definice

Obor názvů:: System.Collections.Specialized

Sestavení:: System.dll, System.Collections.Specialized.dll

Sestavení:: System.Collections.Specialized.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Zdroj:: OrderedDictionary.cs

Zdroj:: OrderedDictionary.cs

Zdroj:: OrderedDictionary.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá položku se zadaným klíčem a hodnotou do OrderedDictionary kolekce s nejnižším dostupným indexem.

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)

Parametry

key: Object

Klíč položky, která se má přidat.

value: Object

Hodnota položky, která se má přidat. Tato hodnota může být null.

Implementuje

Add(Object, Object)

Výjimky

NotSupportedException

Kolekce OrderedDictionary je jen pro čtení.

ArgumentException

Prvek se stejným klíčem již v kolekci OrderedDictionary existuje.

Příklady

Následující příklad kódu ukazuje vytvoření a populaci OrderedDictionary kolekce. Tento kód je součástí většího příkladu kódu, který lze zobrazit na adrese 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)

Poznámky

Klíč nemůže být null, ale hodnota může být.

Vlastnost můžete použít Item[] také k přidání nových prvků nastavením hodnoty klíče, který v kolekci OrderedDictionary neexistuje. Pokud však zadaný klíč již v objektu OrderedDictionaryexistuje, nastavení Item[] vlastnosti přepíše starou hodnotu. Naproti tomu metoda neupravuje existující prvky, Add ale místo toho vyvolá ArgumentException.

Platí pro

Sdílet prostřednictvím