# C零基础入门篇(14.Dictionary 使用指南)

## 1. 简介
`Dictionary<TKey, TValue>` 是 C# 中一个非常常用的泛型集合类，用于存储键值对（Key-Value Pair）。它可以根据键快速查找对应的值，因此在需要快速查找和检索数据的场景下非常高效。

## 2. 基本概念
- **TKey**：键的类型，必须是唯一的。
- **TValue**：值的类型，可以是任意类型。

## 3. 创建字典

### 3.1 创建空字典
```
using System.Collections.Generic;

Dictionary<string, int> ageDict = new Dictionary<string, int>();
```
创建一个以字符串为键、整数为值的空字典。

### 3.2 初始化字典
```
Dictionary<int, string> fruits = new Dictionary<int, string>
{
    { 1, "Apple" },
    { 2, "Banana" },
    { 3, "Cherry" }
};
```
使用键值对初始化字典。

## 4. 添加元素

### 4.1 使用 `Add()` 方法
```
ageDict.Add("Alice", 25);
ageDict.Add("Bob", 30);
```
如果键已存在，`Add()` 方法会抛出异常。

### 4.2 使用索引符 `[]`
```
ageDict["Alice"] = 26;
```
如果键已存在，会更新对应的值。

## 5. 访问元素

### 5.1 直接访问
```
string value = fruits[1];  // 返