C# TaskCompletionSource

TaskCompletionSource<T> 的核心作用是:手动控制一个 Task 的完成状态 。它适合把回调、事件、外部信号转成 await 能用的 Task。

基本用法

csharp 复制代码
var tcs = new TaskCompletionSource<string>(
    TaskCreationOptions.RunContinuationsAsynchronously);

// 消费方
string result = await tcs.Task;

// 生产方在回调/事件里完成
tcs.TrySetResult("ok");

常用方法

方法 作用
tcs.Task 返回等待方使用的 Task
TrySetResult(v) 标记成功,返回 bool,重复调用不抛异常
TrySetException(ex) 标记失败
TrySetCanceled() 标记取消
SetResult(v) 强制完成,重复调用会抛 InvalidOperationException

生产环境建议统一用 TrySet*,避免回调多次触发时崩溃。

桥接事件/回调

csharp 复制代码
public Task<string> WaitForMessageAsync()
{
    var tcs = new TaskCompletionSource<string>(
        TaskCreationOptions.RunContinuationsAsynchronously);

    void Handler(object? s, string msg)
    {
        _messageSource.Received -= Handler;
        tcs.TrySetResult(msg);
    }

    _messageSource.Received += Handler;
    return tcs.Task;
}

加超时

csharp 复制代码
var tcs = new TaskCompletionSource<string>(
    TaskCreationOptions.RunContinuationsAsynchronously);

var timeout = Task.Delay(3000);
var completed = await Task.WhenAny(tcs.Task, timeout);

if (completed == timeout)
    throw new TimeoutException();

return await tcs.Task;

注意:TCS 超时只是让等待方不再等,底层操作不一定真的被取消。

关键点

  • 构造时加 RunContinuationsAsynchronously,防止续体在设置结果的线程上同步执行,减少死锁风险。
  • TCS 只能完成一次,状态一旦变成 Completed / Faulted / Canceled 就不能再改。
  • 需要重复使用时,每次创建新实例,不要复用已完成的 TCS。
相关推荐
武昌库里写JAVA11 小时前
SpringBoot+Vue 项目介绍
java·javascript·git·sql·ai
学长毕设12 小时前
基于SpringBoot的儿童慈善捐赠管理系统-附源码
java·spring boot·后端
慧一居士12 小时前
@RestControllerAdvice 的注解作用和使用
java
ComPDFKit13 小时前
RAG 回答只显示 PDF 文件名?用 Python 保留引用页码
开发语言·python·pdf·rag
FRing0313 小时前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3
学长毕设13 小时前
基于SpringBoot非遗文化展示与传播平台设计与实现-附源码
java·spring boot·后端
金銀銅鐵15 小时前
用 Swing 重做操作数栈演示
java·jvm·后端
琳少_15 小时前
java程序开发笔记
java·开发语言·数据库·笔记
七夜zippoe15 小时前
Agent 告警设计:分级告警、智能降噪与值班排班
开发语言·ai·agent·告警·智能降噪·值班排班
叼烟扛炮17 小时前
[LangChain] 学习笔记(15):为什么你的重试没用——429、抖动、fallback 与熔断
java·服务器·前端