說明
必須包含名空間System.Collection.Generic
Dictionary裡面的每一個元素都是一個索引值對(由二個元素組成:鍵和值)
鍵必須是唯一的,而值不需要唯一的
鍵和值都可以是任何類型(比如:string, int, 自訂類型,等等)
通過一個鍵讀取一個值的時間是接近O(1)
索引值對之間的偏序可以不定義
使用方法:
//定義 Dictionary<string, string> openWith = new Dictionary<string, string>(); //添加元素 openWith.Add("txt", "notepad.exe"); openWith.Add("bmp", "paint.exe"); openWith.Add("dib", "paint.exe"); openWith.Add("rtf", "wordpad.exe"); //取值 Console.WriteLine("For key = \"rtf\", value = {0}.", openWith["rtf"]); //更改值 openWith["rtf"] = "winword.exe"; Console.WriteLine("For key = \"rtf\", value = {0}.", openWith["rtf"]); //遍曆key foreach (string key in openWith.Keys) { Console.WriteLine("Key = {0}", key); } //遍曆value foreach (string value in openWith.Values) { Console.WriteLine("value = {0}", value); } //遍曆value, Second Method Dictionary<string, string>.ValueCollection valueColl = openWith.Values; foreach (string s in valueColl) { Console.WriteLine("Second Method, Value = {0}", s); } //遍曆字典 foreach (KeyValuePair<string, string> kvp in openWith) { Console.WriteLine("Key = {0}, Value = {1}", kvp.Key, kvp.Value); } //添加存在的元素 try { openWith.Add("txt", "winword.exe"); } catch (ArgumentException) { Console.WriteLine("An element with Key = \"txt\" already exists."); } //刪除元素 openWith.Remove("doc"); if (!openWith.ContainsKey("doc")) { Console.WriteLine("Key \"doc\" is not found."); } //判斷鍵存在 if (openWith.ContainsKey("bmp")) // True { Console.WriteLine("An element with Key = \"bmp\" exists."); } //參數為其它類型 Dictionary<int, string[]> OtherType = new Dictionary<int, string[]>(); OtherType.Add(1, "1,11,111".Split(',')); OtherType.Add(2, "2,22,222".Split(',')); Console.WriteLine(OtherType[1][2]); //參數為自訂類型//首先定義類 class DouCube { public int Code { get { return _Code; } set { _Code = value; } } private int _Code; public string Page { get { return _Page; } set { _Page = value; } } private string _Page; } //然後聲明並添加元素 Dictionary<int, DouCube> MyType = new Dictionary<int, DouCube>(); for (int i = 1; i <= 9; i++) { DouCube element = new DouCube(); element.Code = i * 100; element.Page = "http://www.doucube.com/" + i.ToString() + ".html"; MyType.Add(i, element); } //遍曆元素 foreach (KeyValuePair<int, DouCube> kvp in MyType) { Console.WriteLine("Index {0} Code:{1} Page:{2}", kvp.Key, kvp.Value.Code, kvp.Value.Page); }
常用屬性
名稱 說明
Comparer 擷取用於確定字典中的鍵是否相等的 IEqualityComparer<T>。
Count 擷取包含在 Dictionary<TKey, TValue> 中的鍵/值對的數目。
Item 擷取或設定與指定的鍵相關聯的值。
Keys 擷取包含 Dictionary<TKey, TValue> 中的鍵的集合。
Values 擷取包含 Dictionary<TKey, TValue> 中的值的集合。
常用方法
名稱 說明
Add 將指定的鍵和值添加到字典中。
Clear 從 Dictionary<TKey, TValue> 中移除所有的鍵和值。
ContainsKey 確定 Dictionary<TKey, TValue> 是否包含指定的鍵。
ContainsValue 確定 Dictionary<TKey, TValue> 是否包含特定值。
Equals(Object) 確定指定的 Object 是否等於當前的 Object。 (繼承自 Object。)
Finalize 允許對象在“記憶體回收”回收之前嘗試釋放資源並執行其他清理操作。 (繼承自 Object。)
GetEnumerator 返回逐一查看 Dictionary<TKey, TValue> 的列舉程式。
GetHashCode 用作特定類型的雜湊函數。 (繼承自 Object。)
GetObjectData 實現 System.Runtime.Serialization.ISerializable 介面,並返回序列化 Dictionary<TKey, TValue> 執行個體所需的資料。
GetType 擷取當前執行個體的 Type。 (繼承自 Object。)
MemberwiseClone 建立當前 Object 的淺表副本。 (繼承自 Object。)
OnDeserialization 實現 System.Runtime.Serialization.ISerializable 介面,並在完成還原序列化之後引發還原序列化事件。
Remove 從 Dictionary<TKey, TValue> 中移除所指定的鍵的值。
ToString 返回表示當前對象的字串。 (繼承自 Object。)
TryGetValue 擷取與指定的鍵相關聯的值。