0

0

c# 字典 dictionary 用法

星降

星降

发布时间:2026-01-16 13:33:28

|

478人浏览过

|

来源于php中文网

原创

安全取值应优先用 TryGetValue(),避免 KeyNotFoundException;添加键值对需据场景选 Add()(禁止覆盖)、索引器(允许覆盖)或 TryAdd()(仅首次添加);预设容量可减少扩容开销;遍历无序,需排序或按插入顺序时应借助 LINQ 或其他集合。

c# 字典 dictionary 用法

怎么安全地取值?别再用 dict[key] 直接访问了

直接写 dict["user1"] 看似简洁,但只要键不存在,立刻抛出 KeyNotFoundException——线上服务一崩就是这个原因。真实项目里,键来源常来自用户输入、配置文件或数据库字段,根本不能假设“一定存在”。

  • ✅ 推荐用 TryGetValue():安全、高效、一行搞定
  • ❌ 避免 ContainsKey() + dict[key] 两次查找:性能白丢一半
  • ⚠️ GetValueOrDefault() 可用,但注意默认值是类型默认值(比如 int 是 0,stringnull),容易掩盖逻辑错误
Dictionary userMap = new Dictionary { ["user1"] = "Alice" };
if (userMap.TryGetValue("user2", out string name))
{
    Console.WriteLine($"找到用户:{name}");
}
else
{
    Console.WriteLine("用户不存在");
}

添加键值对时,Add()、索引器、TryAdd() 到底该选谁?

三者行为完全不同,混用会导致逻辑混乱甚至数据丢失

  • Add():键已存在 → 立刻抛 ArgumentException;适合“严格不允许覆盖”的场景(如注册唯一ID)
  • 索引器赋值(dict[key] = value):键存在则覆盖,不存在则新增;适合缓存更新、状态快照等
  • TryAdd()(.NET Core 2.0+ / .NET 5+):键不存在才添加,存在则静默失败并返回 false;适合并发初始化或“只设一次”的配置项
var config = new Dictionary(StringComparer.OrdinalIgnoreCase);
config.TryAdd("Timeout", "30");      // 成功
config.TryAdd("timeout", "60");      // 失败(忽略大小写,键已存在),返回 false
config["Timeout"] = "45";            // 强制覆盖为 45

为什么预设容量很重要?不是说字典能自动扩容吗?

能扩,但每次扩容都要重建整个哈希表:重新计算所有键的哈希值、重排 Entry[] 数组、复制数据——这会卡主线程,实测在万级数据插入时,不预设容量比预设慢 3–5 倍。

php 配置文件php.ini的中文注释版(09.4)
php 配置文件php.ini的中文注释版(09.4)

在WINDOWS下,编译时的路径是WINDOWS安装目录。 ; 在命令行模式下,PHP.INI的查找路径可以用 -C 参数替代。 ; 该文件的语法非常简单。空白字符和用分号´;´开始的行被简单地忽略(就象你可能 ; 猜到的一样)。 章节标题(例如 : [FOO])也被简单地忽略,即使将来它们可能 ; 有某种的意义。 ; ;

下载
  • 默认初始容量是 0(实际内部桶数组长度为 3),第一次 Add 就触发扩容
  • 扩容策略是质数序列(如 3→7→13→29…),频繁扩容还会导致内存碎片
  • 如果你知道大概要存 2000 条记录,直接写 new Dictionary(2048)
// ✅ 好习惯:按需预估,向上取最近的质数(或直接略大一点)
var userCache = new Dictionary(10_000);

// ❌ 别这样:让字典自己反复 realloc
var badCache = new Dictionary(); // 后续 Add 1w 次,至少扩容 10+ 次

遍历和排序:字典天生无序,想按插入顺序或 Key 排序得绕个弯

Dictionary 内部是哈希表,foreach 遍历顺序 ≠ 插入顺序,也 ≠ Key 大小顺序。这是高频误解点,尤其做导出、日志、调试时容易翻车。

  • 要按插入顺序:改用 System.Collections.Generic.Dictionary 不行,得换 System.Collections.ObjectModel.KeyedCollection 或自行维护 List>
  • 要按键排序:用 LINQ 的 OrderBy()(返回 IOrderedEnumerable,非字典)
  • 要按值排序:同理,但注意值可能重复,Key 会丢失
var scores = new Dictionary { ["Bob"] = 85, ["Alice"] = 92, ["Charlie"] = 78 };

// 按 Key 字母序输出(注意:结果是新序列,不是字典)
var sorted = scores.OrderBy(kv => kv.Key);
foreach (var kv in sorted)
{
    Console.WriteLine($"{kv.Key}: {kv.Value}");
}
// 输出:Alice: 92, Bob: 85, Charlie: 78
字典的“快”建立在哈希正确、无冲突、容量合理的基础上;一旦键的 GetHashCode() 实现不稳定,或者大量键哈希碰撞,性能会断崖下跌——这点比语法细节更值得花时间验证。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

315

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

231

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

436

2024.03.01

php中foreach用法
php中foreach用法

本专题整合了php中foreach用法的相关介绍,阅读专题下面的文章了解更多详细教程。

42

2025.12.04

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

315

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

538

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

52

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

197

2025.08.29

C++ 单元测试与代码质量保障
C++ 单元测试与代码质量保障

本专题系统讲解 C++ 在单元测试与代码质量保障方面的实战方法,包括测试驱动开发理念、Google Test/Google Mock 的使用、测试用例设计、边界条件验证、持续集成中的自动化测试流程,以及常见代码质量问题的发现与修复。通过工程化示例,帮助开发者建立 可测试、可维护、高质量的 C++ 项目体系。

3

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
10分钟--Midjourney创作自己的漫画
10分钟--Midjourney创作自己的漫画

共1课时 | 0.1万人学习

Midjourney 关键词系列整合
Midjourney 关键词系列整合

共13课时 | 0.9万人学习

AI绘画教程
AI绘画教程

共2课时 | 0.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号