OrderedDictionary.Add(Object, Object) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Voegt een vermelding met de opgegeven sleutel en waarde toe aan de OrderedDictionary verzameling met de laagste beschikbare index.
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 -> unitPublic Sub Add (key As Object, value As Object)Parameters
- key
- Object
De sleutel van de vermelding die moet worden toegevoegd.
- value
- Object
De waarde van de vermelding die moet worden toegevoegd. Deze waarde kan zijn null.
Implementeringen
Uitzonderingen
De OrderedDictionary verzameling heeft het kenmerk Alleen-lezen.
Er bestaat al een element met dezelfde sleutel in de OrderedDictionary verzameling.
Voorbeelden
In het volgende codevoorbeeld ziet u het maken en de populatie van een OrderedDictionary verzameling. Deze code maakt deel uit van een groter codevoorbeeld dat kan worden bekeken op 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)
Opmerkingen
Een sleutel kan niet zijn null, maar een waarde kan zijn.
U kunt de Item[] eigenschap ook gebruiken om nieuwe elementen toe te voegen door de waarde in te stellen van een sleutel die niet bestaat in de OrderedDictionary verzameling. Als de opgegeven sleutel echter al bestaat in de OrderedDictionaryeigenschap, wordt de oude waarde overschreven door de Item[] eigenschap in te stellen. De methode wijzigt daarentegen geen bestaande elementen, Add maar genereert in plaats daarvan ArgumentException.