File.GetCreationTime(String) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
返回指定文件或目录的创建日期和时间。
public:
static DateTime GetCreationTime(System::String ^ path);public static DateTime GetCreationTime(string path);static member GetCreationTime : string -> DateTimePublic Shared Function GetCreationTime (path As String) As DateTime参数
- path
- String
要为其获取创建日期和时间信息的文件或目录。
返回
设置为 DateTime 指定文件或目录的创建日期和时间的结构。 此值以本地时间表示。
例外
调用方没有所需的权限。
低于 2.1 的 .NET Framework 和 .NET Core 版本： path 是长度为零的字符串，仅包含空格，或包含一个或多个无效字符。 可以使用该方法 GetInvalidPathChars() 查询无效字符。
path 是 null。
指定的路径、文件名或两者都超过了系统定义的最大长度。
path 格式无效。
示例
下面的示例演示了 GetCreationTime.
Imports System.IO
Module Module1
Sub Main()
Dim fileCreatedDate As DateTime = File.GetCreationTime("C:\Example\MyTest.txt")
Console.WriteLine("file created: " + fileCreatedDate)
End Sub
End Module
注解
注释
此方法可能会返回不准确的值，因为它使用本机函数，其值可能不会由操作系统持续更新。
允许参数 path 指定相对路径或绝对路径信息。 相对路径信息解释为相对于当前工作目录。 若要获取当前工作目录，请参阅 GetCurrentDirectory。
如果参数中描述的 path 文件不存在，此方法返回 1601 年 1 月 1 日午夜 12：00（C.E.）协调世界时（UTC），调整为当地时间。
NTFS 格式的驱动器可能会在短时间内缓存有关文件的信息，例如文件创建时间。 因此，如果要覆盖或替换现有文件，则可能需要显式设置文件的创建时间。
有关常见 I/O 任务的列表，请参阅 常见 I/O 任务。