FileSystemInfo.CreationTimeUtc 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取或设置当前文件或目录的创建时间，其格式为协调世界时 (UTC)。

public:
 property DateTime CreationTimeUtc { DateTime get(); void set(DateTime value); };

public DateTime CreationTimeUtc { get; set; }

[System.Runtime.InteropServices.ComVisible(false)]
public DateTime CreationTimeUtc { get; set; }

member this.CreationTimeUtc : DateTime with get, set

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreationTimeUtc : DateTime with get, set

Public Property CreationTimeUtc As DateTime

当前 FileSystemInfo 对象的创建日期及时间（UTC 格式）。

IOException

Refresh() 不能初始化数据。

指定的路径无效：例如，它位于未映射的驱动器上。

当前操作系统不是 Windows NT 或更高版本。

调用方试图设置无效的创建时间。

注意

此方法可能返回不准确的值，因为它使用本机函数，其值可能不会由操作系统持续更新。

如果对象的当前实例FileSystemInfo是从以下DirectoryInfo任一方法返回的，则会预先缓存属性的值CreationTimeUtc：

若要获取最新值，请调用 Refresh 方法。

如果对象中描述的 FileSystemInfo 文件不存在，则此属性返回 1601 年 1 月 1 日午夜 12：00， (C.E.) 协调世界时 (UTC) 。

在不支持创建或出生时间的 Unix 平台上，此属性返回上次状态更改的时间和上次修改时间的旧时间。在其他平台上，它返回 1601 年 1 月 1 日午夜 12：00， (C.E.) 协调世界时 (UTC) ，调整为本地时间。

NTFS 格式的驱动器可能会在短时间内缓存文件元信息，例如文件创建时间。此过程称为文件隧道。因此，如果要覆盖或替换现有文件，可能需要显式设置文件的创建时间。