【.Net实用方法总结】 整理并总结System.IO中File类及其方法介绍

🐋作者简介：博主是一位.Net开发者，同时也是RPA和低代码平台的践行者。
🐬个人主页：会敲键盘的肘子
🐰系列专栏：.Net实用方法总结
🦀专栏简介：博主针对.Net开发和C站问答过程中遇到的问题进行总结，形成本专栏，希望可以帮助到您解决问题。
🐶座右铭：总有一天你所坚持的会反过来拥抱你。

---

🌈写在前面：

本文主要介绍System.IO命名空间的File 类，介绍其常用的方法和示例说明。

---

👉本文关键字：System.IO、File类、文件信息、方法示例、C#

1️⃣ System.IO命名空间

.NET中的IO操作命名空间，包含允许读写文件和数据流的类型以及提供基本文件和目录支持的类型。

我们在.NET中的IO操作，经常需要调用一下几个类。

• FileStream类

​ 文件流类，负责大文件的拷贝，读写。

• Path类

​ Path类中方法，基本都是对字符串（文件名）的操作，与实际文件没多大关系。

• File类

  File类可以进行一些对小文件拷贝、剪切操作，还能读一些文档文件。

• Dirctory类

  目录操作，创建文件、删除目录，获取目录下文件名等等。

2️⃣ File类

♈ 定义

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

public static class File
1

♉ 自定义各种方法的行为的枚举

FileAccess 定义文件的读取、写入或读/写访问权限的常量

[System.Flags]
public enum FileAccess
1
2

FileShare 包含用于控制其他FileStream对象对同一文件可以具有的访问类型的常数

[System.Flags]
public enum FileShare
1
2

FileMode 指定操作系统打开文件的方式

public enum FileMode
1

♊ 常用方法

Copy(String, String, Boolean) 将现有文件复制到新文件。 允许覆盖同名的文件。

public static void Copy (string sourceFileName, string destFileName, bool overwrite);
1

参数

sourceFileName

string

要复制的文件。

destFileName

string

目标文件的名称。 它不能是一个目录或现有文件。

overwrite

bool

如果可以覆盖目标文件，则为 true；否则为 false。

示例

以下示例将文件复制到 C：\archives\2008 备份文件夹。 它使用 方法的两个 Copy 重载，如下所示：

• 它首先使用 File.Copy(String, String) 方法重载来复制文本 (.txt) 文件。 代码演示此重载不允许覆盖已复制的文件。
• 然后，它 File.Copy(String, String, Boolean) 使用 方法重载将图片 (.jpg 文件) 。 该代码演示此重载允许覆盖已复制的文件。

string sourceDir = @"c:\current";
string backupDir = @"c:\archives\2008";

try
{
    string[] picList = Directory.GetFiles(sourceDir, "*.jpg");
    string[] txtList = Directory.GetFiles(sourceDir, "*.txt");

    // Copy picture files.
    foreach (string f in picList)
    {
        // Remove path from the file name.
        string fName = f.Substring(sourceDir.Length + 1);

        // Use the Path.Combine method to safely append the file name to the path.
        // Will overwrite if the destination file already exists.
        File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName), true);
    }

    // Copy text files.
    foreach (string f in txtList)
    {

        // Remove path from the file name.
        string fName = f.Substring(sourceDir.Length + 1);

        try
        {
            // Will not overwrite if the destination file already exists.
            File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName));
        }

        // Catch exception if the file was already copied.
        catch (IOException copyError)
        {
            Console.WriteLine(copyError.Message);
        }
    }

    // Delete source files that were copied.
    foreach (string f in txtList)
    {
        File.Delete(f);
    }
    foreach (string f in picList)
    {
        File.Delete(f);
    }
}

catch (DirectoryNotFoundException dirNotFound)
{
    Console.WriteLine(dirNotFound.Message);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

Create(String) 在指定路径中创建或覆盖文件

public static System.IO.FileStream Create (string path);
1

参数

path

string

要创建的文件的路径及名称。

返回

FileStream

一个 FileStream，它提供对 path 中指定的文件的读/写访问。

示例

以下示例在指定的路径中创建文件，将一些信息写入该文件，然后从该文件中读取。

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        try
        {
            // Create the file, or overwrite if the file exists.
            using (FileStream fs = File.Create(path))
            {
                byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                // Add some information to the file.
                fs.Write(info, 0, info.Length);
            }

            // Open the stream and read it back.
            using (StreamReader sr = File.OpenText(path))
            {
                string s = "";
                while ((s = sr.ReadLine()) != null)
                {
                    Console.WriteLine(s);
                }
            }
        }

        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

Create(String, Int32, FileOptions) 创建或覆盖指定路径中的文件，指定缓冲区大小和一个描述如何创建或覆盖该文件的选项

public static System.IO.FileStream Create (string path, int bufferSize, System.IO.FileOptions options);
1

参数

path

string

要创建的文件的路径及名称。

bufferSize

int

用于读取和写入到文件的已放入缓冲区的字节数。

options

FileOptions

FileOptions 值之一，它描述如何创建或覆盖该文件。

返回

FileStream

具有指定缓冲区大小的新文件。

示例

以下示例演示如何在创建文件流时使用异步值。

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteToFile();
        }

        static async void WriteToFile()
        {
            byte[] bytesToWrite = Encoding.Unicode.GetBytes("example text to write");
            using (FileStream createdFile = File.Create("c:/Temp/testfile.txt", 4096, FileOptions.Asynchronous))
            {
                await createdFile.WriteAsync(bytesToWrite, 0, bytesToWrite.Length);
            }
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

Delete(String) 删除指定的文件

public static void Delete (string path);
1

参数

path

string

要删除的文件的名称。 不支持通配符。

示例

以下示例将文件组复制到 C：\archives\2008 备份文件夹，然后从源文件夹中将其删除。

string sourceDir = @"c:\current";
string backupDir = @"c:\archives\2008";

try
{
    string[] picList = Directory.GetFiles(sourceDir, "*.jpg");
    string[] txtList = Directory.GetFiles(sourceDir, "*.txt");

    // Copy picture files.
    foreach (string f in picList)
    {
        // Remove path from the file name.
        string fName = f.Substring(sourceDir.Length + 1);

        // Use the Path.Combine method to safely append the file name to the path.
        // Will overwrite if the destination file already exists.
        File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName), true);
    }

    // Copy text files.
    foreach (string f in txtList)
    {

        // Remove path from the file name.
        string fName = f.Substring(sourceDir.Length + 1);

        try
        {
            // Will not overwrite if the destination file already exists.
            File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName));
        }

        // Catch exception if the file was already copied.
        catch (IOException copyError)
        {
            Console.WriteLine(copyError.Message);
        }
    }

    // Delete source files that were copied.
    foreach (string f in txtList)
    {
        File.Delete(f);
    }
    foreach (string f in picList)
    {
        File.Delete(f);
    }
}

catch (DirectoryNotFoundException dirNotFound)
{
    Console.WriteLine(dirNotFound.Message);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

Exists(String) 确定指定的文件是否存在

public static bool Exists (string? path);
1

参数

path

string

文件或目录的路径。

返回

bool

如果 path 指向现有目录，则为 true；如果该目录不存在或者在尝试确定指定目录是否存在时出错，则为 false。

示例

下面的示例确定文件是否存在。

string curFile = @"c:\temp\test.txt";
Console.WriteLine(File.Exists(curFile) ? "File exists." : "File does not exist.");
1
2

GetCreationTime(String) 返回指定文件或目录的创建日期和时间

public static DateTime GetCreationTime (string path);
1

参数

path

string

目录的路径。

返回

DateTime

一个设置为指定目录的创建日期和时间的结构。 该值用本地时间表示。

示例

下面的示例演示了 GetCreationTime 。

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            // Get the creation time of a well-known directory.
            DateTime dt = Directory.GetCreationTime(Environment.CurrentDirectory);

            // Give feedback to the user.
            if (DateTime.Now.Subtract(dt).TotalDays > 364)
            {
                Console.WriteLine("This directory is over a year old.");
            }
            else if (DateTime.Now.Subtract(dt).TotalDays > 30)
            {
                Console.WriteLine("This directory is over a month old.");
            }
            else if (DateTime.Now.Subtract(dt).TotalDays <= 1)
            {
                Console.WriteLine("This directory is less than a day old.");
            }
            else
            {
                Console.WriteLine("This directory was created on {0}", dt);
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

Move(String, String) 将指定文件移到新位置，提供要指定新文件名的选项

public static void Move (string sourceFileName, string destFileName);
1

参数

sourceFileName

string

要移动的文件的名称。 可以包括相对或绝对路径。

destFileName

string

文件的新路径和名称。

示例

下面的示例将移动一个文件。

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        string path2 = @"c:\temp2\MyTest.txt";
        try
        {
            if (!File.Exists(path))
            {
                // This statement ensures that the file is created,
                // but the handle is not kept.
                using (FileStream fs = File.Create(path)) {}
            }

            // Ensure that the target does not exist.
            if (File.Exists(path2))	
            File.Delete(path2);

            // Move the file.
            File.Move(path, path2);
            Console.WriteLine("{0} was moved to {1}.", path, path2);

            // See if the original exists now.
            if (File.Exists(path))
            {
                Console.WriteLine("The original file still exists, which is unexpected.");
            }
            else
            {
                Console.WriteLine("The original file no longer exists, which is expected.");
            }			
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

Open(String, FileMode) 通过不共享的读/写访问权限打开指定路径上的 FileStream

public static System.IO.FileStream Open (string path, System.IO.FileMode mode);
1

参数

path

string

要打开的文件。

mode

FileMode

FileMode 值，用于指定在文件不存在时是否创建该文件，并确定是保留还是覆盖现有文件的内容。

返回

FileStream

以读/写访问与不共享权限打开的指定模式和路径上的 FileStream

示例

下面的代码示例创建一个临时文件并向其中写入一些文本。 然后，该示例使用 T:System.IO.FileMode.Open 打开该文件;也就是说，如果该文件不存在，则不会创建它。

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        // Create a temporary file, and put some data into it.
        string path = Path.GetTempFileName();
        using (FileStream fs = File.Open(path, FileMode.Open, FileAccess.Write, FileShare.None))
        {
            Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (FileStream fs = File.Open(path, FileMode.Open))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);

            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

Replace(String, String, String) 使用其他文件的内容替换指定文件的内容，这一过程将删除原始文件，并创建被替换文件的备份

public static void Replace (string sourceFileName, string destinationFileName, string? destinationBackupFileName);
1

参数

sourceFileName

string

替换由 destinationFileName 指定的文件的文件名。

destFileName

string

被替换文件的名称。

destinationBackupFileName

string

备份文件的名称。

示例

下面的代码示例使用 Replace 方法将文件替换为其他文件，并创建被替换文件的备份。

using System;
using System.IO;

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                string OriginalFile = "test.xml";
                string FileToReplace = "test2.xml";
                string BackUpOfFileToReplace = "test2.xml.bac";

                Console.WriteLine("Move the contents of " + OriginalFile + " into " + FileToReplace + ", delete " + OriginalFile +
                                   ", and create a backup of " + FileToReplace + ".");

                // Replace the file.
                ReplaceFile(OriginalFile, FileToReplace, BackUpOfFileToReplace);

                Console.WriteLine("Done");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }

        // Move a file into another file, delete the original, and create a backup of the replaced file.
        public static void ReplaceFile(string FileToMoveAndDelete, string FileToReplace, string BackupOfFileToReplace)
        {
            File.Replace(FileToMoveAndDelete, FileToReplace, BackupOfFileToReplace, false);
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

♋ 注解

使用 File 类执行典型操作，例如一次复制、移动、重命名、创建、打开、删除和追加到单个文件。 你还可以使用 File 类来获取和设置文件特性或 DateTime 与文件的创建、访问和写入相关的信息。 如果要对多个文件执行操作，请参阅 Directory.GetFiles 或 DirectoryInfo.GetFiles 。

由于所有 File 方法都是静态的，因此 File FileInfo 如果你只想执行一个操作，则使用方法（而不是相应的实例方法）可能更有效。 所有 File 方法都需要正在处理的文件的路径。

类的静态方法对 File 所有方法执行安全检查。 如果要多次重用某个对象，请考虑改用的相应实例方法 FileInfo ，因为安全检查并不总是必需的。

默认情况下，将向所有用户授予对新文件的完全读/写访问权限。

♌ 更多方法

更多方法请查阅官方文档File 类。

---

⭐写在结尾：

文章中出现的任何错误请大家批评指出，一定及时修改。

希望写在这里的小伙伴能给个三连支持！