0. 前言

继续之前的 C# IO 流，在前几篇小短片中我们大概看了下 C# 的基础 IO 也对文件、目录和路径的操作有了一定的了解。这一篇开始，给大家演示一下流的各种操作。以文件流为例，一起来看看如何操作吧。

注：之前更新了一篇《Spring Cloud 实战日记》，这是一个新的系列，有兴趣的小伙伴可以从我的账号首页进去看看。

1. 简单的 IO 流读写文件

先来看一部分代码：

class Program
{static void Main(string[] args)
    {var directory = Directory.GetCurrentDirectory();
        var program = File.Open("../../../Program.cs", FileMode.OpenOrCreate);
        // program = File.Open("Program.cs", FileMode.OpenOrCreate);
        var buffers = new byte[1024];// 创建一个 8k 的缓存区
        var list = new List<byte>();
        while(true)
        {int length = program.Read(buffers, 0, buffers.Length);
            if(length <=0)
            {break;}
            list.AddRange(buffers.Take(length));
        }

        program.Close();
        Console.WriteLine(list.Count);
    }
}

到目前为止，打开了一个流读取当前程序源文件，每次读取到一个字节数组里，然后将数据放到 list 集合里，在读取完成后关闭这个流。虽然以上流并没有太多意义，但是基本演示了一下流的读取操作。

注意到注释的那行代码和上一行代码的区别吗？在编译阶段，Directory.GetCurrentDirectory() 表示源文件所在目录；在运行阶段，表示程序编译完成的 DLL 所在目录。

输出结果：

以上通过文件流演示了如何读取一个文件，那么我们来简单看看如何通过流写文件：

class Program
{static void Main(string[] args)
    {var directory = Directory.GetCurrentDirectory();
        var program = File.Open("Program.cs", FileMode.OpenOrCreate);
        var buffers = new byte[1024];// 创建一个 8k 的缓存区
        var list = new List<byte>();
        while(true)
        {int length = program.Read(buffers, 0, buffers.Length);
            if(length <=0)
            {break;}
            list.AddRange(buffers.Take(length));
        }
        program.Close();
        Console.WriteLine($"已读取：{list.Count}");
        var tempr = File.Open("Program_01.cs", FileMode.OpenOrCreate);
        tempr.Write(list.ToArray(), 0, list.Count);
        tempr.Close();}
}

以上方法通过读取当前源码文件，然后将数据写入到另一个文件中：”Program_01.cs“。如果运行无误的话，将会得到一个”Program_01.cs“文件。

2. 使用流适配器

普通的流读取和写入都是使用字节数组，这在实际开发中非常不方便，所以 C#又在流的基础上开发了流适配器。C# 中流适配器是指 XXXReader 或者 XXXWriter，这种类在初始化的时候传入一个流作为操作对象，然后对这个流进行一定的封装，简化了其操作方法。

现在以 StreamReader 为例，来看看具体如何使用：

public StreamReader (System.IO.Stream stream);
public StreamReader (System.IO.Stream stream, System.Text.Encoding encoding);

这里是两个以流为主要参数的构造方法，不同的是一个指定了文本编码 encoding，另一个默认使用系统的文本编码。

public StreamReader (string path);
public StreamReader (string path, System.Text.Encoding encoding);

这两个是通过指定文件的路径，然后打开一个 StreamReader 对象。

现在我们来看下这个 Reader 对象有哪些方法或者说我们常用的方法有哪些吧：

public override int Read ();
public override int Read (char[] buffer, int index, int count);

读取字符，与普通的流不同的是，StreamReader 的读取是以字符为单位的读取，而 char 类型与 int 之间存在一定的转换关系，所以方法 Read() 的返回值是 int。

public override string ReadLine ();

这个方法的意思是一次读一行，如果读到末尾则返回 null。

public override string ReadToEnd ();

这个方法的意思是一次性读完剩余的数据然后返回一个字符串。

照例，Reader 提供了流的关闭和销毁方法：

public override void Close ();

现在让我们来改造一下第一节的示例程序：

class Program
{static void Main(string[] args)
    {var reader = new StreamReader("Program.cs");
        while(true)
        {var str = reader.ReadLine();
            if(str == null)
            {break;}
            Console.WriteLine(str);
        }
        reader.Close();}
}

这段代码的意思是读取当前主程序的文件，然后按行打印。打印结果应该类似于：

这是我本地的代码文件。

简单的介绍了一下 StreamReader，然后我们来看一下 StreamWriter 如何使用。按照我的惯例，先从构造函数来：

public StreamWriter (System.IO.Stream stream);
public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding);

与 StreamReader 类似，打开一个允许写的流。

public StreamWriter (string path);
public StreamWriter (string path, bool append);
public StreamWriter (string path, bool append, System.Text.Encoding encoding);

打开 path 对应的文件，然后将数据写入到文件中。append 表示当文件存在时，数据是追加到文件末尾还是覆盖文件。

然后看一下它的方法：

public override void Write (string value);
public override void Write (string format, object arg0, object arg1, object arg2);
public override void Write (string format, params object[] arg);

Write 方法提供了很多个重载版本，但是我们只需要关注这三个即可。第一个很简单，直接写一个字符串。如果把第二个方法和第三个方法结合起来，然后再联系一下 String.Format 我想很多小伙伴就知道怎么使用了。没错，这两个方法的效果就是下面这种方式：

var value = string.Format(string format, params object[] arg);
writer.Write(value);

public override void WriteLine (string value);
public override void WriteLine (string format, object arg0, object arg1, object arg2);
public override void WriteLine (string format, params object[] arg);

同时 C# 也添加了一组 WriteLine 的方法，该方法与 Write 不同的是，WriteLine 会在写入数据后向流里追加一个换行符，所以这个方法是写入一行。

不过，在使用 Writer 的时候需要注意以下这三个方法：

public override void Flush ();
public override void Close ();
protected override void Dispose (bool disposing);

其中 Dispose（销毁）是受保护的方法，一般场景中遇不到。Flush 表示将 Writer 的数据推送到基础流里，Close 表示关闭 Writer 顺便关闭基础流。

在 C# 中，对 Close 动作进行了进一步优化。当调用 Close 方法的时候，系统会自动调用 Flush 方法将数据推送到基础流中。那么，为什么还提供了 Flush 呢？因为如果要操作一个大数据或者数据的来源是分批，这时候为了保证之前的数据不会丢失就需要我们手动调用 Flush 把数据推送给基础流了。

嗯，所以我们来写个程序验证一下：

class Program
{static void Main(string[] args)
    {var reader = new StreamReader("Program.cs");
        var writer = new StreamWriter("Program.cs.txt");
        while(true)
        {var str = reader.ReadLine();
            if(str == null)
            {break;}
            Console.WriteLine(str);
            writer.WriteLine(str);
        }
        //writer.Close();
        reader.Close();}
}

如示例，在注释了 writer.Close(); 之后，程序依然会生成一个 Program.cs.txt 文件，但文件是空的。这时候取消注释，就会发现 Program 已经复制到了 Program.cs.txt 里。

3. 常用的有哪些适配器流

1. BinaryReader

用特定的编码将基元数据类型读作二进制值

2. BinaryWriter

将二进制中的基元类型写入流并支持用特定的编码写入字符串

3.StringReader

从字符串中读取字符串

4.StringWriter

将信息写入字符串中

5.XmlReader/XmlWriter

对 xml 文件的快速操作

这几个是出镜率较高的，但仍有很多选手藏在幕后，并非是它们不出镜，而是它们经常活跃在特定的领域里。所以这里就没有做过多的介绍。

4. 后言

到这里，IO 流基础知识介绍完毕。C#基础知识系列，也只剩下《异常篇》、《实战准备篇》以及《C#基础实战篇 - 文件检索工具》这三大篇章了。C# 系列的下一个篇章就是数据访问系列，会介绍 AOD.NET、Entity Framework 等数据访问框架。

附：

上文中提到的 System.Text.Encoding 是一种文本编码类，表示字符串的编码格式。常用的有 UTF-8，GBK2312 等。其中 C# 在 Encoding 类添加了几大常用编码格式的静态属性，返回的是 Encoding 实例。

public static System.Text.Encoding UTF8 {get;}
public static System.Text.Encoding ASCII {get;}

更多内容烦请关注我的博客《高先生小屋》