OrderedDictionary.Add(Object, Object) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將指定鍵與值 OrderedDictionary 的條目加入索引最低的集合。
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 -> unitPublic Sub Add (key As Object, value As Object)參數
- key
- Object
新增的重點是。
- value
- Object
這個條目的價值值得加入。 這個值可以是 null。
實作
例外狀況
本 OrderedDictionary 合集為唯讀。
集合中已經 OrderedDictionary 存在具有相同鍵的元素。
範例
以下程式碼範例展示了集合的 OrderedDictionary 建立與建立。 此程式碼是更大程式碼範例的一部分，可於 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)
備註
索引鍵不能 null，但值可以是 。
你也可以利用該 Item[] 屬性來新增元素，方法是設定一個不存在 OrderedDictionary 於集合中的鍵值;但如果指定的鍵已經存在 OrderedDictionary於集合中，設定該 Item[] 屬性會覆蓋舊值。 相較之下，該 Add 方法不修改現有元素，而是拋出 ArgumentException。
