0

0

c# 在 C# 中使用 FileStream 的异步 API 和性能

幻夢星雲

幻夢星雲

发布时间:2026-01-10 11:09:37

|

266人浏览过

|

来源于php中文网

原创

FileStream异步API默认不加速,因默认使用线程池模拟异步而非真正的重叠I/O;必须显式设置useAsync:true且文件系统支持(如NTFS)才能启用底层异步。

c# 在 c# 中使用 filestream 的异步 api 和性能

FileStream 异步 API 为什么默认不加速?

直接调用 FileStream.ReadAsyncFileStream.WriteAsync 在多数情况下并不会比同步版本快,甚至更慢——除非你显式启用了操作系统级别的异步 I/O 支持。.NET 默认创建的 FileStream 实例使用的是「同步句柄 + 线程池模拟异步」模式,本质是把 Read/Write 丢进 ThreadPool 执行,并非真正的 overlapped I/O。

关键判断点:只有在构造时传入 useAsync: true,且底层文件系统支持(如 NTFS、ReFS,且非 FAT32/网络共享/某些 Docker 卷),才能触发真正的异步 I/O。

  • new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, bufferSize: 4096, useAsync: true) —— 必须显式设为 true
  • 若省略 useAsync 或设为 false,即使调用 ReadAsync,也走线程池模拟
  • Windows 上启用 useAsync: true 后,.NET 会调用 CreateFileFILE_FLAG_OVERLAPPED 标志打开句柄

useAsync = true 的实际限制和常见失败场景

设了 useAsync: true 不代表一定成功。运行时可能静默降级回同步模拟,尤其在以下情况:

  • 打开的是重定向的 stdin/stdout(如控制台应用中 Console.OpenStandardInput()
  • 路径指向 FAT32 分区、SMB 共享(Windows)、CIFS/NFS 挂载点(Linux/macOS)
  • 文件被其他进程以不兼容方式打开(例如未设 FILE_SHARE_READ
  • Docker 容器中挂载的 host 目录(取决于存储驱动和宿主机 FS)

验证是否真异步:检查 FileStream.IsAsync 属性——它只反映构造时是否请求了异步,不保证 OS 层面生效;更可靠的方式是用 ETW 或 PerfView 观察 ThreadPoolWorkerThread 是否被大量占用,或用 Process Explorer 查看句柄属性中的 «Overlapped» 标志。

缓冲区大小与 async 性能的关系

异步 I/O 的吞吐优势高度依赖缓冲区大小。太小(如 256 字节)会导致频繁的系统调用和完成端口调度开销;太大(如 1 MB)可能浪费内存且不提升速度,尤其对 SSD 或高速 NVMe。

推荐值范围:

Magic AI Avatars
Magic AI Avatars

神奇的AI头像,获得200多个由AI制作的自定义头像。

下载
  • 普通 HDD / SATA SSD:bufferSize = 64 * 1024(64 KB)
  • NVMe / 高并发服务:bufferSize = 128 * 1024256 * 1024
  • 避免 bufferSize 小于 4 KB(NTFS 最小簇大小),否则底层可能拆成多个 IRP

注意:bufferSizeFileStream 内部缓冲,和 Stream.ReadAsync 传入的 Memory<byte> 大小无关——后者只是用户目标缓冲,前者才影响系统调用效率。

真实高性能异步读写的典型写法

下面是一个兼顾正确性、可诊断性和性能的 FileStream 异步读取示例,包含错误防护和关键注释:

var options = new FileStreamOptions
{
    Access = FileAccess.Read,
    Mode = FileMode.Open,
    Share = FileShare.Read,
    BufferSize = 65536,
    Options = FileOptions.Asynchronous // 等价于 useAsync: true,更明确
};
<p>await using var fs = new FileStream(@"C:\data.bin", options);</p><p>// 使用栈分配 Span 避免 GC 压力(仅限固定大小场景)
var buffer = new byte[65536];
int totalRead = 0;</p><p>while (true)
{
int read = await fs.ReadAsync(buffer, CancellationToken.None);
if (read == 0) break;
totalRead += read;
// 处理 buffer[..read],例如写入网络或解析
}

关键点:用 FileStreamOptions 替代老式构造函数,语义清晰;FileOptions.Asynchronous 是唯一可靠的开启方式;循环中不要重复 new byte[],复用缓冲区。

真正难处理的不是 API 调用,而是确认「异步是否落地」——这需要结合 OS 层观测,而不是只看代码有没有 async 关键字。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

765

2023.08.10

console接口是干嘛的
console接口是干嘛的

console接口是一种用于在计算机命令行或浏览器开发工具中输出信息的工具,提供了一种简单的方式来记录和查看应用程序的输出结果和调试信息。本专题为大家提供console接口相关的各种文章、以及下载和课程。

420

2023.08.08

console.log是什么
console.log是什么

console.log 是 javascript 函数,用于在浏览器控制台中输出信息,便于调试和故障排除。想了解更多console.log的相关内容,可以阅读本专题下面的文章。

541

2024.05.29

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1496

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1170

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

835

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

463

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2362

2023.08.08

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

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

精品课程

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

共48课时 | 10.6万人学习

Git 教程
Git 教程

共21课时 | 4.2万人学习

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

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