C# 文件流操作方法 C#如何使用FileStream

来源:这里教程网 时间:2026-02-21 17:38:55 作者:

FileStream 构造函数参数怎么选

创建

FileStream
最容易出错的地方是构造函数参数组合不匹配。比如用
FileMode.Create
却传了
FileAccess.Read
,运行时直接抛
ArgumentException
:“The file access requested is not compatible with the access required by the file mode.”

FileMode
决定文件存在与否时的行为(如
Create
总是清空重写,
OpenOrCreate
存在则打开、不存在则新建)
FileAccess
是你打算对流做的操作(
Read
/
Write
/
ReadWrite
),必须和
FileMode
兼容:比如
FileMode.Append
只允许
FileAccess.Write
FileShare
控制其他进程能否同时访问该文件;默认
FileShare.None
会独占锁,若另一程序正读这个文件,你的
FileStream
就会阻塞或抛
IOException

用 using 管理 FileStream 是必须的吗

是。不显式调用

Dispose()
或不用
using
,文件句柄不会立即释放,可能导致后续操作失败(如“文件正由另一进程使用”)、磁盘空间无法回收、甚至 AppDomain 卸载异常。

常见错误写法:

FileStream fs = new FileStream("log.txt", FileMode.Append, FileAccess.Write);
fs.Write(buffer, 0, buffer.Length);
// 忘了 fs.Close() 或 fs.Dispose()

正确写法:

using (FileStream fs = new FileStream("log.txt", FileMode.Append, FileAccess.Write, FileShare.Read))
{
    fs.Write(buffer, 0, buffer.Length);
} // 自动调用 Dispose,释放句柄并刷新缓冲区

即使发生异常,
using
块仍保证
Dispose()
被调用
如果手动管理,必须在
finally
中调用
Dispose()
,且要判空
FileStream
Dispose()
会隐式调用
Flush()
,但不保证磁盘落盘(需配合
Flush(true)
强制写入物理设备)

Read/Write 方法返回值为什么不能忽略

FileStream.Read()
FileStream.Write()
都返回实际操作的字节数,不是“成功就返回传入长度”。尤其在网络映射盘、加密文件系统或磁盘满时,可能只写入部分数据却无异常抛出。

典型误用:

fs.Write(buffer, 0, buffer.Length); // ❌ 假设全部写完

安全写法:

int totalWritten = 0;
while (totalWritten < buffer.Length)
{
    int written = fs.Write(buffer, totalWritten, buffer.Length - totalWritten);
    if (written == 0) throw new IOException("Write returned 0 bytes — stream may be closed or full.");
    totalWritten += written;
}

Read()
同理:返回 0 表示已到流末尾,不是“读完了所有请求字节”
同步 I/O 下,
Read()
可能一次只读几字节(尤其小缓冲区 + 大文件)
若需原子性写入,应先写临时文件,再
File.Move()
替换原文件

FileStream 和 File 类方法有什么本质区别

File.OpenRead()
File.ReadAllBytes()
这些是封装好的快捷方式,底层仍用
FileStream
,但它们隐藏了生命周期控制和缓冲策略细节。

File.ReadAllBytes("a.bin")
会一次性把整个文件加载进内存 —— 文件超 100MB 就容易 OOM
File.Copy()
默认不保留 NTFS 权限或时间戳,而用
FileStream
手动复制可控制每个字节、加进度回调、做校验
高频小文件写入(如日志)用
FileStream
配合
BufferedStream
更可控;简单读取配置可用
File.ReadAllText()
FileStream
支持
Seek()
随机读写,
File
类静态方法全是一次性顺序操作

真正需要精细控制 I/O 行为、处理大文件、或避免内存暴涨时,绕不开直接用

FileStream
。其他情况,优先选
File
类方法更简洁安全。

相关推荐