命名空间:

System.IO

程序集:

System.Runtime.dll

提供用于创建、复制、删除、移动和打开文件的属性和实例方法，并且帮助创建 FileStream 对象。 此类不能被继承。

C#复制

public sealed class FileInfo : System.IO.FileSystemInfo

继承

Object

MarshalByRefObject

FileSystemInfo

FileInfo

示例

以下示例演示了 FileInfo 类的一些主要成员。

首次检索属性时， FileInfo 调用 Refresh 该方法并缓存有关该文件的信息。 在后续调用中，必须调用 Refresh 以获取信息的最新副本。

C#复制

using System;
using System.IO;
 
class Test
{
    
    public static void Main()
    {
        string path = Path.GetTempFileName();
        var fi1 = new FileInfo(path);
 
        // Create a file to write to.
        using (StreamWriter sw = fi1.CreateText())
        {
            sw.WriteLine("Hello");
            sw.WriteLine("And");
            sw.WriteLine("Welcome");
        }	
 
        // Open the file to read from.
        using (StreamReader sr = fi1.OpenText())
        {
            var s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
 
        try
        {
            string path2 = Path.GetTempFileName();
            var fi2 = new FileInfo(path2);
 
            // Ensure that the target does not exist.
            fi2.Delete();
 
            // Copy the file.
            fi1.CopyTo(path2);
            Console.WriteLine($"{path} was copied to {path2}.");
 
            // Delete the newly created file.
            fi2.Delete();
            Console.WriteLine($"{path2} was successfully deleted.");
        }
        catch (Exception e)
        {
            Console.WriteLine($"The process failed: {e.ToString()}");
        }
    }
}

此示例生成类似于以下内容的输出。

复制

Hello  
And  
Welcome  
C:\Users\userName\AppData\Local\Temp\tmp70AB.tmp was copied to C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp.  
C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp was successfully deleted.  

注解

将 FileInfo 类用于典型的操作，例如复制、移动、重命名、创建、打开、删除和追加到文件。

如果要对同一文件执行多个操作，则使用 FileInfo 实例方法（而不是类的相应静态方法 File ）可能更高效，因为安全检查并不总是必要的。

创建或打开文件时， FileInfo 许多方法都会返回其他 I/O 类型。 可以使用这些其他类型的进一步操作文件。 有关详细信息，请参阅特定FileInfo成员，例如Open、、OpenReadOpenText、CreateText或Create。

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

下表介绍了用于自定义各种 FileInfo 方法行为的枚举。

 备注

在接受路径作为输入字符串的成员中，该路径的格式必须良好或引发异常。 例如，如果路径完全限定，但以空格开头，则路径不会在类的方法中修整。 因此，路径格式不正确，并引发异常。 同样，路径或路径的组合不能完全限定两次。 例如，在大多数情况下，“c：\temp c：\windows”也会引发异常。 使用接受路径字符串的方法时，请确保路径格式良好。

在接受路径的成员中，路径可以引用文件或仅引用目录。 指定的路径还可以引用服务器和共享名称的相对路径或通用命名约定 (UNC) 路径。 例如，以下所有路径都是可接受的路径：

• C# 中的“c：\\MyDir\\MyFile.txt”，或Visual Basic中的“c:\MyDir\MyFile.txt”。

• C# 中的“c：\\MyDir”或Visual Basic中的“c：\MyDir”。

• C# 中的“MyDir\\MySubdir”或Visual Basic中的“MyDir\MySubDir”。

• C# 中的“\\\\MyServer\\MyShare”或Visual Basic中的“\\MyServer\MyShare”。

该 FileInfo 类提供以下属性，可用于检索有关文件的信息。 有关如何使用每个属性的示例，请参阅属性页。

• 该 Directory 属性检索一个对象，该对象表示文件的父目录。

• 该 DirectoryName 属性检索文件父目录的完整路径。

• 该 Exists 属性在对文件执行操作之前检查是否存在文件。

• 该 IsReadOnly 属性检索或设置一个值，该值指定是否可以修改文件。

• 检索 Length 文件的大小。

• 检索 Name 文件的名称。

构造函数

字段

属性

方法

扩展方法

适用于