okkkk 发表于 2025-2-6 23:56:19

AsyncLocal的妙用

AsyncLocal<T>是一个在.NET中用来在同步任务和异步任务中保持全局变量的工具类。
它允许你在不同线程的同一个对象中保留一个特定值,这样你可以在不同的函数和任务中访问这个值。
这是在实现异步任务中维持一致性和优雅性的一种重要手段。
用法

创建一个AsyncLocal实例:
你可以使用AsyncLocal<T>来创建一个特定类型的实例,比如:
AsyncLocal<string> asyncLocalString = new AsyncLocal<string>();设置值:
你可以通过Value属性设置或者读取值:
asyncLocalString.Value = "Hello, AsyncLocal!";读取值:
在任务中的任意位置,你都可以读取这个值:
Console.WriteLine(asyncLocalString.Value);实例分享与给值变更:
在不同任务和串行任务中,AsyncLocal 实例的值是不一样的:
asyncLocalString.Value = "Main Task";Task.Run(() =>{    asyncLocalString.Value = "Child Task";    Console.WriteLine(asyncLocalString.Value); // 输出 "Child Task"});Console.WriteLine(asyncLocalString.Value); // 输出 "Main Task"场景

数据传递:
异步任务中,通过AsyncLocal进行全局数据传递而无需通过参数传递。这对于学习和复用代码很有帮助。
上下文管理:
在ASP.NET Core中,AsyncLocal 可用于管理用户请求上下文,实现不同请求之间的传递。当你需要保存一些请求相关的信息时,这是一种很有效的方法。
百分比信息保存:
记录不同任务和串行任务中的特定信息,说明这些任务是如何分布的。这在分析和跟踪异步操作时应对特别有用。
系统日志和跟踪:
AsyncLocal 可用于在异步任务中保存和分享日志和跟踪信息,以便在运行时采集最有益的信息,有助于问题跟踪和分析。
示例:保存日志和租户信息

以下是一个使用AsyncLocal保存日志和租户信息的示例:
using System;using System.Threading;using System.Threading.Tasks;public class LogContext{    public string StackTrace { get; set; }    public string UserInfo { get; set; }}public class TenantContext{    public string Name { get; set; }}public class Program{    private static AsyncLocal<LogContext> _logContext = new AsyncLocal<LogContext>();    private static AsyncLocal<TenantContext> _tenantContext = new AsyncLocal<TenantContext>();    public static async Task Main(string[] args)    {      _logContext.Value = new LogContext { StackTrace = "Main Stack Trace", UserInfo = "User1" };      _tenantContext.Value = new TenantContext { Name = "Tenant A" };      Console.WriteLine($"Initial Log Context: {_logContext.Value.StackTrace}, User: {_logContext.Value.UserInfo}, Tenant: {_tenantContext.Value.Name}");      await Task.Run(() => LogAndProcess(new LogContext { StackTrace = "Child Stack Trace", UserInfo = "User2" }, new TenantContext { Name = "Tenant B" }));      Console.WriteLine($"After Task Log Context: {_logContext.Value.StackTrace}, User: {_logContext.Value.UserInfo}, Tenant: {_tenantContext.Value.Name}");    }    private static void LogAndProcess(LogContext logContext, TenantContext tenant)    {      _logContext.Value = logContext;      _tenantContext.Value = tenant;      Console.WriteLine($"In Task Log Context: {_logContext.Value.StackTrace}, User: {_logContext.Value.UserInfo}, Tenant: {_tenantContext.Value.Name}");      // Simulate some processing      Task.Delay(1000).Wait();      Console.WriteLine($"After Processing Log Context: {_logContext.Value.StackTrace}, User: {_logContext.Value.UserInfo}, Tenant: {_tenantContext.Value.Name}");    }}在这个示例中,AsyncLocal 用于保存日志和租户信息,确保在不同的任务上下文中正确传递和使用这些信息。
页: [1]
查看完整版本: AsyncLocal的妙用