在C#开发中,获取文件或目录的时间属性是文件操作场景下的常见需求,比如需要判断文件是否为最新版本、清理过期文件、记录文件变更日志等,都需要读取文件的创建时间、修改时间、最后访问时间等属性。C#的System.IO命名空间提供了完善的类来支持这些操作,开发者可以根据实际需求选择合适的实现方式。

C#文件时间属性的核心类说明
C#中获取文件系统时间属性主要依赖FileSystemInfo类及其两个派生类FileInfo和DirectoryInfo。FileSystemInfo是所有文件系统信息类的基类,它定义了获取文件或目录基础属性的通用方法,而FileInfo专门用于处理文件相关的属性,DirectoryInfo则用于处理目录相关的属性。
这几个类提供的时间属性主要包含以下三类:
- CreationTime:文件或目录的创建时间,返回DateTime类型
- LastWriteTime:文件或目录的最后修改时间,也就是我们通常说的文件修改时间,返回DateTime类型
- LastAccessTime:文件或目录的最后访问时间,返回DateTime类型
使用FileInfo获取文件的时间属性
如果需要获取单个文件的时间属性,使用FileInfo类是最直接的方式。首先需要实例化FileInfo对象,传入目标文件的完整路径,之后就可以直接访问对应的时间属性。
以下是获取指定文件创建时间、修改时间、最后访问时间的完整示例:
using System;
using System.IO;
namespace FileTimeDemo
{
class Program
{
static void Main(string[] args)
{
// 目标文件路径,这里使用本地测试路径,实际使用时替换为真实路径
string filePath = @"C:testdemo.txt";
// 实例化FileInfo对象
FileInfo fileInfo = new FileInfo(filePath);
// 判断文件是否存在,避免空引用异常
if (fileInfo.Exists)
{
Console.WriteLine("文件创建时间:" + fileInfo.CreationTime);
Console.WriteLine("文件修改时间:" + fileInfo.LastWriteTime);
Console.WriteLine("文件最后访问时间:" + fileInfo.LastAccessTime);
}
else
{
Console.WriteLine("目标文件不存在,请检查路径是否正确");
}
}
}
}
上述代码中,首先引入System.IO命名空间,之后创建FileInfo实例,通过Exists属性判断文件是否存在,避免访问不存在的文件导致异常。如果存在则直接输出三个时间属性的值,这些时间默认是本地时间,如果需要UTC时间,可以使用对应的Utc版本属性,比如CreationTimeUtc、LastWriteTimeUtc、LastAccessTimeUtc。
使用DirectoryInfo获取目录的时间属性
如果需要获取目录的创建、修改时间,使用DirectoryInfo类的逻辑和FileInfo类似,只需要传入目录的完整路径即可。目录的修改时间指的是目录内文件或子目录发生变更的时间。
以下是获取目录时间属性的示例代码:
using System;
using System.IO;
namespace DirectoryTimeDemo
{
class Program
{
static void Main(string[] args)
{
// 目标目录路径
string dirPath = @"C:test";
DirectoryInfo dirInfo = new DirectoryInfo(dirPath);
if (dirInfo.Exists)
{
Console.WriteLine("目录创建时间:" + dirInfo.CreationTime);
Console.WriteLine("目录修改时间:" + dirInfo.LastWriteTime);
Console.WriteLine("目录最后访问时间:" + dirInfo.LastAccessTime);
}
else
{
Console.WriteLine("目标目录不存在,请检查路径是否正确");
}
}
}
}
批量获取多个文件的时间属性
在实际开发中,经常需要批量获取某个目录下所有文件的时间属性,这时候可以结合DirectoryInfo的GetFiles方法和FileInfo的属性来实现。GetFiles方法可以返回目录下所有文件的FileInfo数组,遍历数组即可获取每个文件的时间属性。
以下是批量获取目录下所有txt文件修改时间的示例:
using System;
using System.IO;
namespace BatchFileTimeDemo
{
class Program
{
static void Main(string[] args)
{
string dirPath = @"C:test";
DirectoryInfo dirInfo = new DirectoryInfo(dirPath);
if (dirInfo.Exists)
{
// 获取目录下所有txt文件,支持通配符,*表示任意字符
FileInfo[] txtFiles = dirInfo.GetFiles("*.txt");
foreach (FileInfo file in txtFiles)
{
Console.WriteLine($"文件名:{file.Name},修改时间:{file.LastWriteTime}");
}
}
else
{
Console.WriteLine("目标目录不存在");
}
}
}
}
GetFiles方法还支持传入搜索选项,比如SearchOption.AllDirectories可以搜索当前目录及所有子目录下的文件,满足不同的批量查询需求。
不同时间属性的使用场景说明
在实际使用中,需要根据需求选择合适的时间属性:
- 如果需要判断文件是否为最新上传或生成的,通常使用LastWriteTime属性,因为它会在文件内容发生变更时更新,而CreationTime只在文件首次创建时赋值,后续修改不会改变。
- 如果需要记录文件首次出现的时间,使用CreationTime属性。
- LastAccessTime属性会在文件被读取、执行时更新,但是部分系统可能会关闭访问时间更新功能,所以这个属性的准确性依赖系统配置,使用时需要注意。
注意事项
在使用这些类获取文件时间属性时,需要注意以下几点:
- 操作文件或目录前一定要判断Exists属性,避免文件不存在导致的异常。
- 如果程序没有对应文件或目录的访问权限,会抛出UnauthorizedAccessException异常,建议添加异常处理逻辑。
- 获取的时间默认是本地时区的时间,如果需要跨时区使用,建议统一使用Utc版本的时间属性,避免时区转换问题。
如果需要修改文件的时间属性,也可以直接给这些属性赋值,比如fileInfo.LastWriteTime = DateTime.Now就可以将文件的修改时间设置为当前时间,赋值后需要调用Refresh方法或者重新实例化对象才能获取更新后的属性值。
C#文件修改时间FileSystemInfoFileInfoDirectoryInfo修改时间:2026-06-28 12:36:41