c# await using 的作用 c# IAsyncDisposable 接口_技术教程

await using 是 C# 8.0+ 中用于异步释放实现 IAsyncDisposable 资源的语法，自动调用 DisposeAsync() 并等待完成，避免连接泄漏；需配合 .NET Core 3.0+/5.0+，不支持仅实现 IDisposable 的类型。

await using 是用来替代 using 的异步资源释放语法

当你要释放的资源实现了 IAsyncDisposable（比如数据库连接、HTTP 客户端、文件流等支持异步清理操作的对象），就不能再用传统的 using 语句——它只调用同步的 IDisposable.Dispose()，会阻塞线程。而 await using 会在作用域结束时自动调用 IAsyncDisposable.DisposeAsync()，并等待其完成。

常见错误现象：用普通 using 包裹 HttpClient 或 SqlConnection（.NET 6+ 默认实现 IAsyncDisposable），看似能编译，但实际没触发异步释放逻辑，可能引发连接泄漏或资源未及时归还。

await using 只能用于实现了 IAsyncDisposable 的类型，否则编译报错：error CS8400: Feature 'async disposable' is not available in C# 7.3. Please use language version 8.0 or greater.
必须配合 C# 8.0+ 和 TargetFramework ≥ netcoreapp3.0 / net5.0
不能和 var 混用在声明式写法里（如 await using var x = ... 是合法的；但 await using x = ... 不合法，缺少类型或 var）

IAsyncDisposable 是 .NET 中定义异步清理契约的接口

IAsyncDisposable 就一个方法：ValueTask DisposeAsync()。它不强制你做“真正异步”的事（比如 I/O），但提供了可 await 的统一入口，让上层能自然融入 async/await 流程。

使用场景集中在需要异步释放资源的地方：关闭网络连接、刷盘缓存、释放锁、通知远程服务注销等。比如 SqlDataReader（.NET 6+）、FileStream（开启 isAsync: true 时）、第三方库中的异步信道或客户端对象。

不要在 DisposeAsync() 里直接调用 await Task.Delay(...) 这类无意义的 await，除非真有异步依赖
如果类同时实现 IDisposable 和 IAsyncDisposable，建议 Dispose() 内部抛 NotSupportedException 或记录警告，避免使用者误用同步路径
.NET 运行时不会自动回退到 Dispose()；如果只实现 IDisposable，await using 直接编译失败

await using 和 try-finally + DisposeAsync() 手动写法对比

手动写 try/finally 调用 DisposeAsync() 很容易漏掉 await，或者忘记处理异常（DisposeAsync() 可能抛异常，且不应被吞掉）。await using 把这些细节封装掉了。

await using var stream = new FileStream("log.txt", FileMode.Create, FileAccess.Write, FileShare.None, 4096, true);
await stream.WriteAsync(data, 0, data.Length);

等价于（简化版）：

FileStream stream = null;
try
{
    stream = new FileStream("log.txt", FileMode.Create, FileAccess.Write, FileShare.None, 4096, true);
    await stream.WriteAsync(data, 0, data.Length);
}
finally
{
    if (stream != null)
        await stream.DisposeAsync(); // ← 这里必须 await，否则释放不生效
}