0

0

C# 如何进行异步文件I/O操作 - ReadAsync和WriteAsync

月夜之吻

月夜之吻

发布时间:2025-12-04 09:53:18

|

516人浏览过

|

来源于php中文网

原创

ReadAsync和WriteAsync需配合FileOptions.Asynchronous创建FileStream才能真正异步,否则退化为同步;推荐复用ArrayPool.Shared缓冲区,File类静态方法适合小文件但不适用于超大文件。

c# 如何进行异步文件i/o操作 - readasync和writeasync

在 C# 中,ReadAsyncWriteAsync 是进行高效、非阻塞文件 I/O 的核心方法,它们基于 Stream 类(如 FileStream)提供真正的异步支持,避免线程池资源浪费,特别适合处理大文件或高并发 I/O 场景。

使用 FileStream 配合 ReadAsync 读取文件

必须用 FileOptions.Asynchronous 创建 FileStream,否则 ReadAsync 会退化为同步调用(内部通过线程池模拟异步,失去性能优势)。

  • 打开文件时指定 FileOptions.Asynchronous
  • 推荐配合 MemoryArrayPool.Shared 复用缓冲区,减少 GC 压力
  • 注意:ReadAsync 返回实际读取字节数,可能小于缓冲区长度(尤其是流末尾或网络文件)
示例:
using var fs = new FileStream("data.bin", FileMode.Open, FileAccess.Read, FileShare.Read, bufferSize: 4096, useAsync: true);
var buffer = new byte[8192];
int bytesRead = await fs.ReadAsync(buffer, CancellationToken.None);

使用 WriteAsync 写入文件的正确姿势

和读取一样,写入也依赖底层 FileStream 是否启用异步模式。未启用时,WriteAsync 同样会同步执行。

  • 创建 FileStream 时必须传入 useAsync: true(即 FileOptions.Asynchronous
  • 可直接写入 ReadOnlyMemory,无需复制到数组
  • 若需确保数据落盘,调用 await fs.FlushAsync();但频繁刷盘影响性能,应按需使用
示例:
using var fs = new FileStream("output.txt", FileMode.Create, FileAccess.Write, FileShare.None, 4096, useAsync: true);
var data = Encoding.UTF8.GetBytes("Hello async world!");
await fs.WriteAsync(data, CancellationToken.None);
await fs.FlushAsync(); // 可选:强制写入磁盘

更简洁:File类的高级异步封装

.NET 提供了开箱即用的异步静态方法,内部已正确配置 FileStream,适合简单场景(如读写整个小文件)。

VWO
VWO

一个A/B测试工具

下载
  • File.ReadAllTextAsync / File.WriteAllTextAsync:自动处理编码与流生命周期
  • File.ReadAllBytesAsync / File.WriteAllBytesAsync:适合二进制内容
  • ⚠️ 注意:这些方法会将整个文件加载到内存,不适用于超大文件(>100MB)
示例:
string content = await File.ReadAllTextAsync("config.json");
await File.WriteAllTextAsync("log.txt", "Done at " + DateTime.Now);

异常与取消处理不能少

异步 I/O 操作可能因磁盘满、权限不足、路径不存在等失败,且支持 CancellationToken 主动中断。

  • 始终用 try-catch 捕获 IOExceptionUnauthorizedAccessException 等常见异常
  • CancellationToken 传给所有 Async 方法,响应用户取消或超时
  • 注意:取消操作本身可能抛出 OperationCanceledException,需单独处理
建议结构:
try
{
    await fs.WriteAsync(buffer, cancellationToken);
}
catch (OperationCanceledException)
{
    // 用户主动取消
}
catch (IOException ex)
{
    // 文件系统错误
}

基本上就这些。关键点就两个:用对 FileStream 的构造参数,别忘了传 useAsync: true;再就是合理使用缓冲区和取消令牌。不复杂但容易忽略。

相关专题

更多
线程和进程的区别
线程和进程的区别

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

481

2023.08.10

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

72

2026.01.16

全民K歌得高分教程大全
全民K歌得高分教程大全

本专题整合了全民K歌得高分技巧汇总,阅读专题下面的文章了解更多详细内容。

131

2026.01.16

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

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

54

2026.01.16

java数据库连接教程大全
java数据库连接教程大全

本专题整合了java数据库连接相关教程,阅读专题下面的文章了解更多详细内容。

39

2026.01.15

Java音频处理教程汇总
Java音频处理教程汇总

本专题整合了java音频处理教程大全,阅读专题下面的文章了解更多详细内容。

19

2026.01.15

windows查看wifi密码教程大全
windows查看wifi密码教程大全

本专题整合了windows查看wifi密码教程大全,阅读专题下面的文章了解更多详细内容。

85

2026.01.15

浏览器缓存清理方法汇总
浏览器缓存清理方法汇总

本专题整合了浏览器缓存清理教程汇总,阅读专题下面的文章了解更多详细内容。

43

2026.01.15

ps图片相关教程汇总
ps图片相关教程汇总

本专题整合了ps图片设置相关教程合集,阅读专题下面的文章了解更多详细内容。

11

2026.01.15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 7万人学习

C 教程
C 教程

共75课时 | 4.1万人学习

C++教程
C++教程

共115课时 | 12.7万人学习

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

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