C#集合类：Dictionary泛型集合

 Dictionary是C#中替代原C++ STL模板库中map的集合类型，转载其用法以做备份。

转自http://whx.tzgt.gov.cn/newOperate/html/1/12/123/9301.html
http://www.cnblogs.com/cnherman/articles/1034861.html

 泛型最常见的用途是泛型集合，命名空间System.Collections.Generic 中包含了一些基于泛型的集合类，使用泛型集合类可以提供更高的类型安全性，还有更高的性能，避免了非泛型集合的重复的装箱和拆箱。 
    很多非泛型集合类都有对应的泛型集合类，下面是常用的非泛型集合类以及对应的泛型集合类：

非泛型集合类	泛型集合类
ArrayList	List
HashTable	DIctionary
Queue	Queue
Stack	Stack
SortedList	SortedList

    我们用的比较多的非泛型集合类主要有 ArrayList类 和 HashTable类。我们经常用HashTable 来存储将要写入到数据库或者返回的信息，在这之间要不断的进行类型的转化，增加了系统装箱和拆箱的负担，如果我们操纵的数据类型相对确定的化  用 Dictionary集合类来存储数据就方便多了，例如我们需要在电子商务网站中存储用户的购物车信息( 商品名，对应的商品个数)时，完全可以用 Dictionary 来存储购物车信息，而不需要任何的类型转化。

    下面是简单的例子，包括声明，填充键值对，移除键值对，遍历键值对

    Dictionary < string ,  string >  myDic  =   new  Dictionary < string ,  string > ();
    myDic.Add( " aaa " ,  " 111 " );
    myDic.Add( " bbb " ,  " 222 " );
    myDic.Add( " ccc " ,  " 333 " );
    myDic.Add( " ddd " ,  " 444 " );
     // 如果添加已经存在的键，add方法会抛出异常
     try
     {
        myDic.Add("ddd","ddd");
    }
     catch  (ArgumentException ex)
     {
        Console.WriteLine("此键已经存在：" + ex.Message);
    }
     // 解决add()异常的方法是用ContainsKey()方法来判断键是否存在
     if  ( ! myDic.ContainsKey( " ddd " ))
     {
        myDic.Add("ddd", "ddd");
    }
     else
     {
        Console.WriteLine("此键已经存在：");
    
    }

    // The Add method throws an exception if the new key is 
    // already in the dictionary.
    try
    {
       openWith.Add("txt", "winword.exe");
    }
    catch (ArgumentException)
    {
        Console.WriteLine("An element with Key = /"txt/" already exists.");
    }
    // The Item property is another name for the indexer, so you 
    // can omit its name when accessing elements. 
    Console.WriteLine("For key = /"rtf/", value = {0}.", openWith["rtf"]);

    // The indexer throws an exception if the requested key is
    // not in the dictionary.
    try
    {
        Console.WriteLine("For key = /"tif/", value = {0}.",
        openWith["tif"]);
    }
    catch (KeyNotFoundException)
    {
        Console.WriteLine("Key = /"tif/" is not found.");
    }

     // 而使用索引器来负值时，如果建已经存在，就会修改已有的键的键值，而不会抛出异常
    myDic [ " ddd " ] = " ddd " ;
    myDic[ " eee " ]  =   " 555 " ;
    
     // 使用索引器来取值时，如果键不存在就会引发异常
     try
     {
        Console.WriteLine("不存在的键/"fff/"的键值为：" + myDic["fff"]);
    }
     catch  (KeyNotFoundException ex)
     {
        Console.WriteLine("没有找到键引发异常：" + ex.Message);
    }
     // 解决上面的异常的方法是使用ContarnsKey() 来判断时候存在键，如果经常要取健值得化最好用 TryGetValue方法来获取集合中的对应键值
     string  value  =   "" ;
     if  (myDic.TryGetValue( " fff " ,  out  value))
     {
        Console.WriteLine("不存在的键/"fff/"的键值为：" + value );
    }
     else
     {     
        Console.WriteLine("没有找到对应键的键值"); 
    }

    // ContainsKey can be used to test keys before inserting them.
    if (!openWith.ContainsKey("ht"))
    {
        openWith.Add("ht", "hypertrm.exe");
        Console.WriteLine("Value added for key = /"ht/": {0}", openWith["ht"]);
    }    

     // 下面用foreach 来遍历键值对
     // 泛型结构体 用来存储健值对
     foreach  (KeyValuePair < string ,  string >  kvp  in  myDic)
     {
        Console.WriteLine("key={0},value={1}", kvp.Key, kvp.Value);
    }
     // 获取值得集合
     foreach  ( string  s  in  myDic.Values)
     {
        Console.WriteLine("value={0}", s);
    }
     // 获取值得另一种方式
    Dictionary < string ,  string > .ValueCollection values  =  myDic.Values;
     foreach  ( string  s  in  values)
     {
        Console.WriteLine("value={0}", s);
    }

    // To get the keys alone, use the Keys property.
    Dictionary<string, string>.KeyCollection keyColl = openWith.Keys;
    // The elements of the KeyCollection are strongly typed
    // with the type that was specified for dictionary keys.
    Console.WriteLine();
    foreach( string s in keyColl )
    {
        Console.WriteLine("Key = {0}", s);
    }
    // Use the Remove method to remove a key/value pair.
    Console.WriteLine("/nRemove(/"doc/")");
    openWith.Remove("doc");
    if (!openWith.ContainsKey("doc"))
    {
        Console.WriteLine("Key /"doc/" is not found.");
    }

常用的属性和方法如下：

 

	常用属性	属性说明
	Comparer	获取用于确定字典中的键是否相等的 IEqualityComparer。
	Count	获取包含在 Dictionary 中的键/值对的数目。
	Item	获取或设置与指定的键相关联的值。
	Keys	获取包含 Dictionary 中的键的集合。
	Values	获取包含 Dictionary 中的值的集合。
	常用的方法	方法说明
	Add	将指定的键和值添加到字典中。
	Clear	从 Dictionary 中移除所有的键和值。
	ContainsKey	确定 Dictionary 是否包含指定的键。
	ContainsValue	确定 Dictionary 是否包含特定值。
	Equals	已重载。 确定两个 Object 实例是否相等。 （从 Object 继承。）
	GetEnumerator	返回循环访问 Dictionary 的枚举数。
	GetHashCode	用作特定类型的哈希函数。GetHashCode 适合在哈希算法和数据结构（如哈希表）中使用。 （从 Object 继承。）
	GetObjectData	实现 System.Runtime.Serialization.ISerializable 接口，并返回序列化 Dictionary 实例所需的数据。
	GetType	获取当前实例的 Type。 （从 Object 继承。）
	OnDeserialization	实现 System.Runtime.Serialization.ISerializable 接口，并在完成反序列化之后引发反序列化事件。
	ReferenceEquals	确定指定的 Object 实例是否是相同的实例。 （从 Object 继承。）
	Remove	从 Dictionary 中移除所指定的键的值。
	ToString	返回表示当前 Object 的 String。 （从 Object 继承。）
	TryGetValue	获取与指定的键相关联的值