当前位置：首页 > 技术教程 > 正文

如何在ASP.NET中使用Dictionary？ | ASP.NET集合类实例教程

admin
技术教程
2026-02-09
2742

ASP.NET 中 Dictionary 基本用法实例分析

在 ASP.NET 中，Dictionary<TKey, TValue> 是一个高效的键值对集合，常用于数据存储、配置管理和数据传递，以下通过具体实例分析其核心用法：

创建与初始化

// 创建空字典 Dictionary<string, int> userScores = new Dictionary<string, int>(); // 带初始值的集合初始化器 Dictionary<string, string> config = new Dictionary<string, string>() { ["Theme"] = "Dark", ["Language"] = "zh-CN", ["PageSize"] = "20" };

添加/更新元素

// 添加新键值对 userScores.Add("Alice", 95); // 更安全的添加方式（避免重复键异常） if (!userScores.ContainsKey("Bob")) { userScores.Add("Bob", 88); } // 索引器更新或添加 userScores["Alice"] = 97; // 更新 userScores["Charlie"] = 90; // 自动添加

访问元素

// 直接访问（键不存在时抛出异常） int aliceScore = userScores["Alice"]; // 安全访问模式 if (userScores.TryGetValue("Bob", out int bobScore)) { Console.WriteLine($"Bob's score: {bobScore}"); } else { Console.WriteLine("Bob not found"); }

遍历字典

// 遍历所有键值对 foreach (KeyValuePair<string, int> kvp in userScores) { Debug.WriteLine($"User: {kvp.Key}, Score: {kvp.Value}"); } // 仅遍历键 foreach (string userName in userScores.Keys) { // 处理键... } // 仅遍历值 foreach (int score in userScores.Values) { // 处理值... }

删除元素

// 按键删除 userScores.Remove("Charlie"); // 删除前检查 if (userScores.ContainsKey("InvalidKey")) { userScores.Remove("InvalidKey"); } // 清空字典 userScores.Clear();

实际应用场景

场景1：ASP.NET Core 配置中间件

如何在ASP.NET中使用Dictionary？ | ASP.NET集合类实例教程第1张

场景2：MVC 视图传递动态数据

// Controller 中 public IActionResult UserProfile() { var profileData = new Dictionary<string, object> { ["Username"] = "Alice", ["LastLogin"] = DateTime.Now.AddDays(-1), ["IsPremium"] = true }; return View(profileData); } // View 中使用 @model Dictionary<string, object> <p>Welcome, @Model["Username"]!</p>

场景3：API 响应动态结构

// Web API 控制器 [HttpGet("stats")] public IActionResult GetStats() { var stats = new Dictionary<string, int> { ["ActiveUsers"] = 1420, ["PendingOrders"] = 87, ["DailyVisits"] = 3562 }; return Ok(stats); // 自动序列化为JSON }

重要注意事项

键唯一性
键必须唯一，重复添加会抛出 ArgumentException。
空键限制
TKey 为引用类型时，键不能为 null（值类型无此问题）。
线程安全
非线程安全！多线程环境需使用：
ConcurrentDictionary<string, int> threadSafeDict = new ConcurrentDictionary<string, int>();
自定义键类型
使用自定义类作为键时，必须重写 GetHashCode() 和 Equals()：
public class UserId { public int Id { get; set; } public override int GetHashCode() => Id.GetHashCode(); public override bool Equals(object obj) => obj is UserId other && Id == other.Id; }