C# 文件读取

news2025/4/24 22:01:42

文件读取是指使用 C# 程序从计算机文件系统中获取文件内容的过程。将存储在磁盘上的文件内容加载到内存中，供程序处理。主要类型有：文本文件读取（如 .txt, .csv, .json, .xml）；二进制文件读取（如 .jpg, .png, .exe）。

同步方法

File

ReadAllText

是 C# 中一个简单易用的文件写入方法，它会创建新文件，如果文件已存在则覆盖。

string path = @"D:\CSharpProject\File\MyTest.txt";
string str = File.ReadAllText(path);

ReadLines

获取文件中每行数据组成的集合

string path = @"D:\CSharpProject\File\MyTest.txt";
var list = File.ReadLines(path).ToList();
Console.WriteLine(string.Join(",", list));

ReadAllLines

会一次性将整个文本文件的所有行读取到一个字符串数组中。

string path = @"D:\CSharpProject\File\MyTest.txt";
string[] list = File.ReadAllLines(path);
Console.WriteLine(string.Join(",", list));

ReadAllBytes

一个用于读取二进制文件的方法，它会将整个文件内容读取到一个字节数组中。

string path = @"D:\CSharpProject\File\MyTest.txt";
byte[] str = File.ReadAllBytes(path);

StreamReader

StreamReader 是 System.IO 命名空间中的一个类，专门用于从流（如文件流）中读取字符数据。它提供了高效的文本读取能力，特别适合处理大型文本文件。

方法	描述
`Read()`	读取下一个字符
`ReadLine()`	读取一行字符
`ReadToEnd()`	读取从当前位置到流末尾的所有内容

简单使用

string path = @"D:\CSharpProject\File\MyTest.txt";
using (StreamReader reader = new StreamReader(path))
{
    string content = reader.ReadToEnd();
    Console.WriteLine(content);
}

逐行读取

using (StreamReader reader = new StreamReader("data.txt"))
{
    string line;
    while ((line = reader.ReadLine()) != null)
    {
        Console.WriteLine(line);
    }
}

读取特定数量字符

char[] buffer = new char[100];
using (StreamReader reader = new StreamReader("file.txt"))
{
    int charsRead = reader.Read(buffer, 0, buffer.Length);
    string result = new string(buffer, 0, charsRead);
}

FileStream

FileStream 是 System.IO 命名空间中的一个类，提供了对文件进行低级读写操作的能力。与更高级的 StreamReader/StreamWriter 相比，FileStream 提供了更底层的控制，适合处理二进制文件或需要精细控制文件操作的场景。

using System.IO;

string filePath = "example.bin";

// 使用 using 语句确保资源被正确释放
using (FileStream fileStream = new FileStream(filePath, FileMode.Open))
{
    byte[] buffer = new byte[fileStream.Length];
    int bytesRead = fileStream.Read(buffer, 0, buffer.Length);
    
    Console.WriteLine($"读取了 {bytesRead} 字节");
    // 处理 buffer 中的数据...
}

异步方法

File

ReadAllTextAsync

是ReadAllText的异步实现，功能相同，不会阻塞主线程。

using System.IO;
using System.Threading.Tasks;

public async Task<string> ReadFileContentAsync(string filePath)
{
    return await File.ReadAllTextAsync(filePath);
}

ReadAllLinesAsync

是ReadAllLines的异步实现，功能相同，不会阻塞主线程。

using System.IO;
using System.Threading.Tasks;

public async Task<string[]> ReadFileAsync(string filePath)
{
    return await File.ReadAllLinesAsync(filePath);
}

ReadAllBytesAsync

是ReadAllBytes的异步实现，功能相同，不会阻塞主线程

using System.IO;
using System.Threading.Tasks;

public async Task<byte[]> ReadBinaryFileAsync(string filePath)
{
    return await File.ReadAllBytesAsync(filePath);
}

StreamReader

简单使用

using System.IO;
using System.Threading.Tasks;

async Task<string> ReadFileAllTextAsync(string filePath)
{
    using (StreamReader reader = new StreamReader(filePath))
    {
        return await reader.ReadToEndAsync();
    }
}

异步逐行读取文件

using (StreamReader reader = new StreamReader("data.txt"))
{
    string line;
    while ((line = reader.ReadLine()) != null)
    {
        Console.WriteLine(line);
    }
}

异步读取指定数量字符

async Task<string> ReadChunkAsync(string path, int chunkSize)
{
    using (var reader = new StreamReader(path))
    {
        char[] buffer = new char[chunkSize];
        int bytesRead = await reader.ReadBlockAsync(buffer, 0, chunkSize);
        return new string(buffer, 0, bytesRead);
    }
}

FileStream

using System.IO;
using System.Threading.Tasks;

async Task<byte[]> ReadFileFullyAsync(string filePath)
{
    using (FileStream fs = new FileStream(
        filePath, 
        FileMode.Open, 
        FileAccess.Read, 
        FileShare.Read, 
        bufferSize: 4096, 
        FileOptions.Asynchronous)) // 关键选项
    {
        byte[] buffer = new byte[fs.Length];
        await fs.ReadAsync(buffer, 0, buffer.Length);
        return buffer;
    }
}

对比

方法	特点	适用场景	内存效率	异步支持	典型文件大小
`File.ReadAllText`	一次性读取全部文本	小文本文件处理	低	无	<10MB
`File.ReadAllTextAsync`	异步读取全部文本	UI应用读取小文本	低	有	<10MB
`File.ReadAllLines`	按行读取为数组	需要行处理的小文件	低	无	<10MB
`File.ReadAllLinesAsync`	异步按行读取	UI应用需要行处理	低	有	<10MB
`File.ReadAllBytes`	读取二进制数据	图片/音频等二进制文件	低	无	<50MB
`File.ReadAllBytesAsync`	异步读取二进制	UI应用处理二进制	低	有	<50MB
`File.ReadLines`	延迟行迭代	大文本文件处理	高	无	10MB+
`StreamReader`	灵活文本读取	需要控制读取过程	高	有(Async方法)	任意大小
`FileStream`	底层二进制读取	大文件/随机访问	高	有	任意大小

选择参考

参考项	推荐方法	场景举例
小文本文件处理 ( < 1MB )	ReadAllText ReadAllTextAsync ReadAllLines ReadAllLinesAsync	配置文件读取小型JSON/XML文件解析模板文件加载
大文本文件处理 ( > 10MB )	File.ReadLines (LINQ兼容) StreamReader (逐行处理) StreamReader.ReadLineAsync (异步逐行)	日志文件分析大型CSV数据处理文本文件实时监控
二进制文件处理	File.ReadAllBytes / ReadAllBytesAsync (小文件) FileStream (大文件)	图片/音视频处理文件加密/解密自定义二进制格式解析