C# 输入和输出

C# 流
处理异常
释放资源
示例文本文件
C# File.ReadAllText
C# File.ReadAllLines
C# 创建文件
C# 创建，最后写入，最后访问时间
C# 复制文件
C# IDisposable接口
C# 使用语句
C# using声明
C# MemoryStream
C# StreamReader
C# 计数行
C# StreamWriter
C# FileStream
C# XmlTextReader
C# 创建，移动目录
C# DirectoryInfo

原文： https://zetcode.com/lang/csharp/io/

本章专门介绍 C# 中的输入和输出。 C# 中的输入和输出基于流。

C# 流

流是字节序列的抽象，例如文件，输入/输出设备，进程间通信管道或 TCP/IP 套接字。流将数据从一个点传输到另一点。流还能够处理数据。例如，他们可以压缩或加密数据。在 .NET Framework 中，System.IO命名空间包含允许对数据流和文件进行读写的类型。

C# 为File类中的 I/O 操作提供了高级方法，为StreamReader或StreamWriter等类提供了较低级的方法。

处理异常

I/O 操作容易出错。我们可能会遇到FileNotFoundException或UnauthorizedAccessException之类的异常。与 Java 不同，C# 不会强制程序员手动处理异常。由程序员决定是否手动处理异常。如果在try/catch/finally结构中未手动处理该异常，则该异常由 CLR 处理。

释放资源

I/O 资源必须释放。可以使用Dispose()方法在finally子句中手动释放资源。 using关键字可用于自动释放资源。同样，File类中的方法为我们释放了资源。

示例文本文件

在示例中，我们使用以下简单文本文件：

thermopylae.txt

The Battle of Thermopylae was fought between an alliance of Greek city-states,
led by King Leonidas of Sparta, and the Persian Empire of Xerxes I over the
course of three days, during the second Persian invasion of Greece.

C# `File.ReadAllText`

File提供了用于创建，复制，删除，移动和打开单个文件的静态方法，并有助于创建FileStream对象。

注意：File.ReadAllText()不适合读取非常大的文件。

File.ReadAllText()打开一个文件，以指定的编码读取文件中的所有文本，然后关闭该文件。

Program.cs

using System;
using System.IO;
using System.Text;
namespace ReadFileIntoString
{
    class Program
    {
        static void Main(string[] args)
        {
            var path = @"C:\Users\Jano\Documents\thermopylae.txt";
            var text = File.ReadAllText(path, Encoding.UTF8);
            Console.WriteLine(text);
        }
    }
}

该程序读取thermopylae.txt文件的内容，并将其打印到控制台。

var text = File.ReadAllText(path, Encoding.UTF8);

我们一次性将整个文件读成字符串。在第二个参数中，我们指定编码。

$ dotnet run
The Battle of Thermopylae was fought between an alliance of Greek city-states,
led by King Leonidas of Sparta, and the Persian Empire of Xerxes I over the
course of three days, during the second Persian invasion of Greece.

这是输出。

C# `File.ReadAllLines`

File.ReadAllLines()打开一个文本文件，将文件的所有行读入字符串数组，然后关闭文件。

File.ReadAllLines()是一种使用 C# 读取文件的便捷方法。处理非常大的文件时，不应使用它。

Program.cs

using System;
using System.IO;
namespace ReadAllLines
{
    class Program
    {
        static void Main(string[] args)
        {
            var path = @"C:\Users\Jano\Documents\thermopylae.txt";
            string[] lines = File.ReadAllLines(path);
            foreach (string line in lines)
            {
                Console.WriteLine(line);
            }
        }
    }
}

该示例将文件中的所有行读入字符串数组。我们在foreach循环中遍历数组，并将每一行打印到控制台。

C# 创建文件

File.CreateText()创建或打开用于写入 UTF-8 编码文本的文件。如果文件已经存在，则其内容将被覆盖。

Program.cs

using System;
using System.IO;
namespace CreateFileEx
{
    class Program
    {
        static void Main()
        {
            var path = @"C:\Users\Jano\Documents\cars.txt";
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hummer");
                sw.WriteLine("Skoda");
                sw.WriteLine("BMW");
                sw.WriteLine("Volkswagen");
                sw.WriteLine("Volvo");
            }
        }
    }
}

在示例中，我们创建一个cars.txt文件，并将一些汽车名称写入其中。

using (StreamWriter sw = File.CreateText(path))

CreateText()方法创建或打开一个文件，用于写入 UTF-8 编码的文本。它返回一个StreamWriter对象。

sw.WriteLine("Hummer");
sw.WriteLine("Skoda");
...

我们向流写入两行。

$ cat C:\Users\Jano\Documents\cars.txt
Hummer
Skoda
BMW
Volkswagen
Volvo

我们已成功将五个汽车名称写入文件。

C# 创建，最后写入，最后访问时间

使用File类，我们可以获取文件的创建，最后写入和最后访问时间。 Exists()方法确定指定的文件是否存在。

Program.cs

using System;
using System.IO;
namespace FileTimes
{
    class Program
    {
        static void Main(string[] args)
        {
           var path = @"C:\Users\Jano\Documents\cars.txt";
            if (File.Exists(path))
            {
                Console.WriteLine(File.GetCreationTime(path));
                Console.WriteLine(File.GetLastWriteTime(path));
                Console.WriteLine(File.GetLastAccessTime(path));
            }
        }
    }
}

如果存在指定的文件，我们将确定其创建，最后写入和最后访问时间。

if (File.Exists(path))

如果调用方具有所需的权限并且路径包含现有文件的名称，则Exists()方法返回true。否则为false。如果path为null，无效路径或长度为零的字符串，则此方法还返回false。

Console.WriteLine(File.GetCreationTime(path));
Console.WriteLine(File.GetLastWriteTime(path));
Console.WriteLine(File.GetLastAccessTime(path));

我们得到指定文件的创建时间，上次写入时间和上次访问时间。

$ dotnet run
10/13/2019 1:59:03 PM
10/13/2019 1:59:03 PM
10/13/2019 1:59:03 PM

这是一个示例输出。

C# 复制文件

File.Copy()方法将现有文件复制到新文件。它允许覆盖同名文件。

Program.cs

using System;
using System.IO;
namespace CopyFileEx
{
    class Program
    {
        static void Main(string[] args)
        {
            var srcPath = @"C:\Users\Jano\Documents\cars.txt";
            var destPath = @"C:\Users\Jano\Documents\cars2.txt";
            File.Copy(srcPath, destPath, true);
            Console.WriteLine("File copied");
        }
    }
}

然后，我们将文件的内容复制到另一个文件。

var srcPath = @"C:\Users\Jano\Documents\cars.txt";
var destPath = @"C:\Users\Jano\Documents\cars2.txt";

这是源文件和目标文件。

File.Copy(srcPath, destPath, true);

Copy()方法复制文件。第三个参数指定是否应覆盖文件（如果存在）。

$ dotnet run
File copied

This is a sample output.

C# `IDisposable`接口

流实现IDisposable接口。实现此接口的对象必须尽早手动处理。这是通过在finally块中调用Dispose()方法或利用using语句来完成的。

Program.cs

using System;
using System.IO;
namespace ManualRelease
{
    class Program
    {
        static void Main(string[] args)
        {
            StreamReader sr = null;
            var path = @"C:\Users\Jano\Documents\thermopylae.txt";
            try
            {
                sr = new StreamReader(path);
                Console.WriteLine(sr.ReadToEnd());
            }
            catch (IOException e)
            {
                Console.WriteLine("Cannot read file");
                Console.WriteLine(e.Message);
            }
            catch (UnauthorizedAccessException e)
            {
                Console.WriteLine("Cannot access file");
                Console.WriteLine(e.Message);
            }
            finally
            {
                 sr?.Dispose();
            }
        }
    }
}

在此示例中，我们从磁盘上的文件读取字符。我们手动释放分配的资源。

sr = new StreamReader(path);
Console.WriteLine(sr.ReadToEnd());

StreamReader类用于读取字符。其父级实现IDisposable接口。

} catch (IOException e)
{
    Console.WriteLine("Cannot read file");
    Console.WriteLine(e.Message);
} catch (UnauthorizedAccessException e)
{
    Console.WriteLine("Cannot access file");
    Console.WriteLine(e.Message);
}

可能的异常在catch块中处理。

finally
{
    sr?.Dispose();
}

在finally块中，Dispose()方法清理资源。使用空条件运算符时，仅当变量不是null时，才调用该方法。

C# 使用语句

using语句定义一个范围，在该范围的末尾将放置一个对象。它提供了一种方便的语法，可确保正确使用IDisposable对象。

Program.cs

using System;
using System.IO;
namespace AutomaticCleanup
{
    class Program
    {
        static void Main(string[] args)
        {
            var path = @"C:\Users\Jano\Documents\thermopylae.txt";
            using (var sr = new StreamReader(path))
            {
                Console.WriteLine(sr.ReadToEnd());
            }
        }
    }
}

该示例读取thermopylae.txt文件的内容。资源通过using语句释放。如果我们不处理 IO 异常，则 CLR 将处理它们。

C# `using`声明

using声明是在using关键字之后的变量声明。它告诉编译器声明的变量应放在封闭范围的末尾。从 C# 8.0 开始，using声明可用。

Program.cs

using System;
using System.IO;
namespace UsingDeclaration
{
    class Program
    {
        static void Main(string[] args)
        {
            var path = @"C:\Users\Jano\Documents\thermopylae.txt";
            using var sr = new StreamReader(path);
            Console.WriteLine(sr.ReadToEnd());
        }
    }
}

该示例读取thermopylae.txt文件的内容。当sr变量超出范围时（在Main()方法的末尾），将自动清除资源。

C# `MemoryStream`

MemoryStream是用于处理计算机内存中数据的流。

Program.cs

using System;
using System.IO;
namespace MemoryStreamEx
{
    class Program
    {
        static void Main(string[] args)
        {
            using var ms = new MemoryStream(6);
            ms.WriteByte(9);
            ms.WriteByte(11);
            ms.WriteByte(6);
            ms.WriteByte(8);
            ms.WriteByte(3);
            ms.WriteByte(7);
            ms.Position = 0;
            int rs = ms.ReadByte();
            do
            {
                Console.WriteLine(rs);
                rs = ms.ReadByte();
            } while (rs != -1);
        }
    }
}

我们用MemoryStream将六个数字写入存储器。然后，我们读取这些数字并将其打印到控制台。

using var ms = new MemoryStream(6);

该行创建并初始化一个容量为六个字节的MemoryStream对象。

ms.WriteByte(9);
ms.WriteByte(11);
ms.WriteByte(6);
...

WriteByte()方法在当前位置的当前流中写入一个字节。

ms.Position = 0;

我们使用Position属性将光标在流中的位置设置为开头。

do
{
    Console.WriteLine(rs);
    rs = ms.ReadByte();

} while (rs != -1);

在这里，我们从流中读取所有字节并将其打印到控制台。

$ dotnet run
9
11
6
8
3
7

这是示例的输出。

C# `StreamReader`

StreamReader从字节流中读取字符。默认为 UTF-8 编码。

Program.cs

using System;
using System.IO;

namespace ReadFileEx
{
    class Program
    {
        static void Main(string[] args)
        {
            var path = @"C:\Users\Jano\Documents\thermopylae.txt";

            using var sr = new StreamReader(path);

            while (sr.Peek() >= 0)
            {
                Console.WriteLine(sr.ReadLine());
            }
        }
    }
}

我们读取文件的内容。这次我们使用ReadLine()方法逐行读取文件。

while (sr.Peek() >= 0)
{
    Console.WriteLine(sr.ReadLine());
}

Peek()方法返回下一个可用字符，但不使用它。它指示我们是否可以再次调用ReadLine()方法。如果没有要读取的字符，则返回-1。

C# 计数行

在下一个示例中，我们将对行进行计数。

Program.cs

using System;
using System.IO;

namespace CountingLines
{
    class Program
    {
        static void Main(string[] args)
        {
            int count = 0;
            var path = @"C:\Users\Jano\Documents\thermopylae.txt";

            using var sr = new StreamReader(path);

            while (sr.ReadLine() != null)
            {
                count++;
            }

            Console.WriteLine("There are {0} lines", count);
        }
    }
}

我们正在计算文件中的行数。

while(stream.ReadLine() != null)
{
    count++;
}

在while循环中，我们使用ReadLine()方法从流中读取一行。如果到达输入流的末尾，它将从流或null中返回一行。

$ dotnet run
There are 3 lines

该文件有三行。

C# `StreamWriter`

StreamWriter以特定编码将字符写入流。

Program.cs

using System;
using System.IO;

namespace WriteToFile
{
    class Program
    {
        static void Main(string[] args)
        {
            var path = @"C:\Users\Jano\Documents\newfile.txt";

            using var sw = new StreamWriter(path);

            sw.WriteLine("Today is a beautiful day.");
        }
    }
}

该示例使用StreamWriter将字符串写入文件。

using (var sw = new StreamWriter(path))

我们创建一个新的StreamWriter。默认值是 UTF-8。 StreamWriter将路径作为参数。如果文件存在，它将被覆盖；否则，将创建一个新文件。

$ dotnet run
$ cat C:\Users\Jano\Documents\newfile.txt
Today is a beautiful day.

我们已经使用cat命令显示了文件的内容。

C# `FileStream`

FileStream为文件提供流，同时支持同步和异步读取和写入操作。

StreamReader和StreamWriter处理文本数据，而FileStream处理字节。

Program.cs

using System.IO;
using System.Text;

namespace FileStreamEx
{
    class Program
    {
        static void Main(string[] args)
        {
            var path = @"C:\Users\Jano\Documents\newfile2.txt";

            using var fs = new FileStream(path, FileMode.Append);

            var text = "Фёдор Михайлович Достоевский\n";
            byte[] bytes = new UTF8Encoding().GetBytes(text);

            fs.Write(bytes, 0, bytes.Length);
        }
    }
}

我们用俄语西里尔字母写一些文本到文件中。

using System.Text;

UTF8Encoding类位于System.Text命名空间中。

using var fs = new FileStream(path, FileMode.Append);

创建一个FileStream对象。第二个参数是打开文件的模式。附加模式将打开文件（如果存在）并查找到文件末尾，或创建一个新文件。

var text = "Фёдор Михайлович Достоевский";

这是俄文西里尔文的文字。

byte[] bytes = new UTF8Encoding().GetBytes(text);

从俄语西里尔字母文本创建一个字节数组。

fs.Write(bytes, 0, bytes.Length);

我们将字节写入文件流。

$ cat C:\Users\Jano\Documents\newfile2.txt
Фёдор Михайлович Достоевский

我们显示创建文件的内容。

C# `XmlTextReader`

我们可以使用流来读取 XML 数据。 XmlTextReader是用于读取 C# 中的 XML 文件的类。该类是仅转发和只读的。

我们有以下 XML 测试文件：

languages.xml

<?xml version="1.0" encoding="utf-8" ?>
<languages>
    <language>Python</language>
    <language>Ruby</language>
    <language>Javascript</language>
    <language>C#</language>
</languages>

此文件包含自定义 XML 标记之间的语言名称。

Program.cs

using System;
using System.IO;
using System.Xml;

namespace ReadingXMLFile
{
    public class Program
    {
        static void Main()
        {
            string path = @"C:\Users\Jano\Documents\languages.xml";

            using (var xreader = new XmlTextReader(path))
            {
                xreader.MoveToContent();

                while (xreader.Read())
                {
                    var node = xreader.NodeType switch
                    {
                        XmlNodeType.Element => String.Format("{0}: ", xreader.Name),
                        XmlNodeType.Text => String.Format("{0} \n", xreader.Value),
                        _ => ""
                    };

                    Console.Write(node);
                }
            }
        }
    }
}

本示例从 XML 文件读取数据并将其打印到终端。

using System.Xml;

System.Xml命名空间包含与 Xml 读写相关的类。

using (var xreader = new XmlTextReader(path))

创建一个XmlTextReader对象。它是一种读取器，可提供对 XML 数据的快速，非缓存且仅前向访问。它以文件名作为参数。

xreader.MoveToContent();

MoveToContent()方法移至 XML 文件的实际内容。

while (xreader.Read())

该行从流中读取下一个节点。如果没有更多节点，则Read()方法返回false。

var node = xreader.NodeType switch
{
    XmlNodeType.Element => String.Format("{0}: ", xreader.Name),
    XmlNodeType.Text => String.Format("{0} \n", xreader.Value),
    _ => ""
};

Console.Write(node);

在这里，我们打印元素名称和元素文本。

$ dotnet run
language: Python
language: Ruby
language: Javascript
language: C#

这是示例的输出。

C# 创建，移动目录

System.IO.Directory是一个类，具有用于在目录和子目录中创建，移动和枚举的静态方法。

Program.cs

using System;
using System.IO;

namespace DirectoryEx
{
    class Program
    {
        static void Main(string[] args)
        {
            Directory.CreateDirectory("temp");
            Directory.CreateDirectory("newdir");
            Directory.Move("temp", "temporary");
        }
    }
}

我们创建两个目录，然后重命名其中一个目录。目录在项目文件夹中创建。

Directory.CreateDirectory("temp");

CreateDirectory()方法创建一个新目录。

Directory.Move("temp", "temporary");

Move()方法为指定的目录提供一个新名称。

C# `DirectoryInfo`

DirectoryInfo公开了用于在目录和子目录中创建，移动和枚举的实例方法。

Program.cs

using System;
using System.IO;

namespace ShowContents
{
    class Program
    {
        static void Main(string[] args)
        {
            var path = @"C:\Users\Jano\Documents";
            var dirInfo = new DirectoryInfo(path);

            string[] files = Directory.GetFiles(path);
            DirectoryInfo[] dirs = dirInfo.GetDirectories();

            foreach (DirectoryInfo subDir in dirs)
            {
                Console.WriteLine(subDir.Name);
            }

            foreach (string fileName in files)
            {
                Console.WriteLine(fileName);
            }
        }
    }
}

我们使用DirectoryInfo类遍历特定目录并打印其内容。

var path = @"C:\Users\Jano\Documents";
var DirInfo = new DirectoryInfo(path);

我们显示指定目录的内容。

string[] files = Directory.GetFiles(path);;

我们使用静态GetFiles()方法获取目录的所有文件。

DirectoryInfo[] dirs = dir.GetDirectories();

我们得到所有目录。

foreach (DirectoryInfo subDir in dirs)
{
    Console.WriteLine(subDir.Name);
}

在这里，我们遍历目录并将其名称打印到控制台。

foreach (string fileName in files)
{
    Console.WriteLine(fileName);
}

在这里，我们遍历文件数组并将其名称打印到控制台。

在本章中，我们介绍了 C# 中的输入/输出操作。

C# 流

处理异常

释放资源

示例文本文件

C# File.ReadAllText

C# File.ReadAllLines

C# 创建文件

C# 创建，最后写入，最后访问时间

C# 复制文件

C# IDisposable接口

C# 使用语句

C# using声明

C# MemoryStream

C# StreamReader

C# 计数行

C# StreamWriter

C# FileStream

C# XmlTextReader

C# 创建，移动目录

C# DirectoryInfo

C# `File.ReadAllText`

C# `File.ReadAllLines`

C# `IDisposable`接口

C# `using`声明

C# `MemoryStream`

C# `StreamReader`

C# `StreamWriter`

C# `FileStream`

C# `XmlTextReader`

C# `DirectoryInfo`