Dictionary<TKey,TValue> Class

[seleccionar]

定义

Dictionary的主要用途是提供快速的基于键值的元素查找。Dictionary的结构一般是这样的：Dictionary<[key], [value]> ，它包含在System.Collections.Generic命名空间中。在使用Dictionary前，你必须对它的键类型和值类型进行声明。

描述

1、从一组键（Key）到一组值（Value）的映射，每一个添加项都是由一个值及其相关连的键组成
2、任何键都必须是唯一的
3、键不能为空引用null（VB中的Nothing），若值为引用类型，则可以为空值
4、Key和Value可以是任何类型（string，int，custom class 等）

创建

以 key 的类型为 int , value的类型为string 为例：
Dictionary<int,string> myDictionary = new Dictionary<int,string>();

[seleccionar]

方法

添加元素Dictionary<TKey,TValue>.Add(TKey, TValue)

用于向字典中添加一个具有指定键和值的元素。

• 如果字典中已经存在具有相同键的元素，则 Add 方法将引发 ArgumentException 异常。因为字典的键必须是唯一的，不允许重复。
• 如果字典尚未包含具有相同键的元素，则 Add 方法将在字典中添加一个新的键值对，并将指定的键和值存储在字典中。

清空Dictionary<TKey, TValue>.Clear()

用于从字典中移除所有的键值对，将字典清空。

• 所有键值对都将从字典中移除，字典被清空。
• 字典的 Count 属性将变为 0，指示字典中不再包含任何元素。

移除Dictionary<TKey, TValue>.Remove(TKey key)

从字典中移除具有指定键的元素。

• 如果指定的键存在于字典中，则与该键关联的键值对将被移除，并返回 true。
• 如果指定的键不存在于字典中，则字典保持不变，并返回 false。

包含指定键Dictionary<TKey,TValue>.ContainsKey(TKey)

检查字典中是否包含指定的键。