C# Dictionary.Add()用法及代碼示例

Dictionary.Add()方法用於向字典添加指定的鍵和值。

用法:

public void Add (TKey key, TValue value);

參數：

key: 這是要添加的元素的關鍵。
value: 它是要添加的元素的值。對於引用類型，該值可以為null。

異常：

ArgumentNullException：如果鍵為null。
ArgumentException：如果詞典中已經存在具有相同鍵的元素。

以下示例程序旨在說明Dictionary.Add()方法的使用：

示例1:

// C# code to add the specified key 
// and value into the Dictionary 
using System; 
using System.Collections.Generic; 
  
class GFG { 
  
    // Driver code 
    public static void Main() 
    { 
  
        // Create a new dictionary  
        // of strings, with string keys. 
        Dictionary<string, string> myDict =  
           new Dictionary<string, string>(); 
  
        // Adding key/value pairs in myDict 
        myDict.Add("Australia", "Canberra"); 
        myDict.Add("Belgium", "Brussels"); 
        myDict.Add("Netherlands", "Amsterdam"); 
        myDict.Add("China", "Beijing"); 
        myDict.Add("Russia", "Moscow"); 
        myDict.Add("India", "New Delhi"); 
  
        // To get count of key/value 
        // pairs in myDict 
        Console.WriteLine("Total key/value pairs in"+ 
                    " myDict are : " + myDict.Count); 
  
        // Displaying the key/value 
        // pairs in myDict 
        Console.WriteLine("The key/value pairs"+ 
                           " in myDict are : "); 
  
        foreach(KeyValuePair<string, string> kvp in myDict) 
        { 
            Console.WriteLine("Key = {0}, Value = {1}", 
                              kvp.Key, kvp.Value); 
        } 
    } 
}

輸出：

Total key/value pairs in myDict are : 6
The key/value pairs in myDict are : 
Key = Australia, Value = Canberra
Key = Belgium, Value = Brussels
Key = Netherlands, Value = Amsterdam
Key = China, Value = Beijing
Key = Russia, Value = Moscow
Key = India, Value = New Delhi

示例2:

// C# code to add the specified  
// key and value into the Dictionary 
using System; 
using System.Collections.Generic; 
  
class GFG { 
  
    // Driver code 
    public static void Main() 
    { 
  
        // Create a new dictionary of  
        // strings, with string keys. 
        Dictionary<string, string> myDict =  
          new Dictionary<string, string>(); 
  
        // Adding key/value pairs in myDict 
        myDict.Add("Australia", "Canberra"); 
        myDict.Add("Belgium", "Brussels"); 
        myDict.Add("Netherlands", "Amsterdam"); 
        myDict.Add("China", "Beijing"); 
        myDict.Add("Russia", "Moscow"); 
        myDict.Add("India", "New Delhi"); 
  
        // The Add method throws an 
        // exception if the new key is 
        // already in the dictionary. 
        try { 
  
            myDict.Add("Russia", "Moscow"); 
        } 
  
        catch (ArgumentException) { 
  
            Console.WriteLine("An element with Key "+ 
                     "= \"Russia\" already exists."); 
        } 
    } 
}

輸出：

An element with Key = "Russia" already exists.

注意：

鍵不能為null，但如果TValue是引用類型，則值可以為null。
如果Count小於容量，則此方法將執行O(1)操作。
如果必須增加容量以容納新元素，則此方法將成為O(n)操作，其中n為Count。

參考：

https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.dictionary-2.add?view=netframework-4.7.2

相關用法

注：本文由純淨天空篩選整理自rupesh_rao大神的英文原創作品 C# | Dictionary.Add() Method。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。