0

0

C# ThreadLocal使用方法 C#如何创建线程本地存储

幻夢星雲

幻夢星雲

发布时间:2026-01-24 11:07:03

|

485人浏览过

|

来源于php中文网

原创

ThreadLocal构造时传null直接抛NullReferenceException;工厂函数仅首次访问Value时执行一次;必须显式Dispose防内存泄漏;AsyncLocal才支持async/await上下文流转。

c# threadlocal使用方法 c#如何创建线程本地存储

ThreadLocal 初始化时传 null 会怎样

直接抛 NullReferenceException——因为 ThreadLocal 构造函数不接受 null 值作为默认值提供器,且泛型类型 T 为引用类型时,Value 初始读取返回 null 是合法的,但你不能在构造时传 null 当作工厂委托。

正确做法是显式提供初始化逻辑:

  • new ThreadLocal(() => "default"),避免首次访问时为 null
  • 若依赖外部状态,确保委托无副作用、线程安全(例如不共享可变静态变量)
  • 值类型如 int 默认初始化为 0,但若想设为 42,仍需传工厂: new ThreadLocal(() => 42)

ThreadLocal.Value 被多次读取是否每次都调用工厂函数

不会。工厂函数只在**当前线程首次访问 Value 属性时执行一次**,后续读取直接返回该线程缓存的值。

这正是它和普通局部变量的关键区别:它延迟初始化 + 每线程一份 + 自动隔离。

  • 适合保存线程专属的昂贵对象(如 RegexStringBuilder、数据库连接上下文)
  • 注意:如果工厂返回的是共享对象(比如静态 List),那依然不是线程安全的——ThreadLocal 只管“存储位置”隔离,不管里面存的东西本身是否可共享
  • 若需每次获取都新建实例(极少见),应手动封装逻辑,不要依赖 ThreadLocal 的自动行为

不调用 Dispose 可能导致内存泄漏

ThreadLocal 内部持有对每个线程数据的强引用,.NET Framework 中若线程长期存活(如线程池线程),且 ThreadLocal 实例未被释放,其线程局部值不会被 GC 回收。

Android创建和使用数据库详细指南 中文WORD版
Android创建和使用数据库详细指南 中文WORD版

每个应用程序都要使用数据,Android应用程序也不例外,Android使用开源的、与操作系统无关的SQL数据库--SQLite,本文介绍的就是如何为你的Android应用程序创建和操作SQLite数据库。 数据库支持每个应用程序无论大小的生命线,除非你的应用程序只处理简单的数据,那么就需要一个数据库系统存储你的结构化数据,Android使用SQLite数据库,它是一个开源的、支持多操作系统的SQL数据库,在许多领域广泛使用,如Mozilla FireFox就是使用SQLite来存储配置数据的,iPhon

下载

尤其在 ASP.NET(非 Core)、WinForms 后台线程等场景下容易踩坑。

  • 务必在不再需要时调用 threadLocal.Dispose()
  • 推荐用 using 语句块包裹(仅限生命周期明确的场景,如单次任务)
  • .NET Core / 5+ 对此做了优化,但仍建议显式释放——文档未承诺跨版本行为一致
  • 若值类型是大对象(如 byte[] 数兆),泄漏影响更明显

ThreadLocal 和 AsyncLocal 的核心区别在哪

根本不在“线程”,而在“执行上下文”:ThreadLocal 绑定物理线程,AsyncLocal 绑定 ExecutionContext,能跨 await 流转。

这意味着:

  • async/await 方法中,ThreadLocal.Valueawait 后可能变成另一个线程的值,甚至为初始值(因线程切换)
  • 若需在异步链路中保持上下文(如请求 ID、用户身份),必须用 AsyncLocal,而不是 ThreadLocal
  • 两者不互换;混用会导致逻辑错乱,且无编译错误
  • 没有“自动升级”机制——从同步迁移到异步时,ThreadLocal 必须重构成 AsyncLocal
实际使用中,最容易忽略的是异步场景下的上下文断裂,以及 Dispose 的遗漏。这两点不出问题时毫无征兆,一出就是偶发内存上涨或上下文丢失,排查成本远高于写的时候多加两行。

相关专题

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

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

233

2023.09.22

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

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

437

2024.03.01

string转int
string转int

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

358

2023.08.02

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

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

542

2024.08.29

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

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

53

2025.08.29

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

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

197

2025.08.29

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

482

2023.08.10

default gateway怎么配置
default gateway怎么配置

配置default gateway的步骤:1、了解网络环境;2、获取路由器IP地址;3、登录路由器管理界面;4、找到并配置WAN口设置;5、配置默认网关;6、保存设置并退出;7、检查网络连接是否正常。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

220

2023.12.07

c++空格相关教程合集
c++空格相关教程合集

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

0

2026.01.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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号