FileSystemInfo.CreationTimeUtc 属性

定义

获取或设置当前文件或目录的创建时间,其格式为协调世界时 (UTC)。Gets or sets the creation time, in coordinated universal time (UTC), of the current file or directory.

public:
 property DateTime CreationTimeUtc { DateTime get(); void set(DateTime value); };
[System.Runtime.InteropServices.ComVisible(false)]
public DateTime CreationTimeUtc { get; set; }
member this.CreationTimeUtc : DateTime with get, set
Public Property CreationTimeUtc As DateTime

属性值

当前 FileSystemInfo 对象的创建日期及时间(UTC 格式)。The creation date and time in UTC format of the current FileSystemInfo object.

属性

异常

Refresh() 不能初始化数据。Refresh() cannot initialize the data.

指定的路径无效:例如,它位于未映射的驱动器上。The specified path is invalid; for example, it is on an unmapped drive.

当前操作系统不是 Windows NT 或更高版本。The current operating system is not Windows NT or later.

调用方试图设置无效的访问时间。The caller attempts to set an invalid access time.

注解

备注

此方法可能会返回不正确的值, 因为它使用的本机函数的值可能不会持续由操作系统进行更新。This method may return an inaccurate value because it uses native functions whose values may not be continuously updated by the operating system.

如果FileSystemInfo对象的当前CreationTimeUtc实例是从以下DirectoryInfo任一方法返回的, 则该属性的值将被预先缓存:The value of the CreationTimeUtc property is pre-cached if the current instance of the FileSystemInfo object was returned from any of the following DirectoryInfo methods:

若要获取最新值, 请Refresh调用方法。To get the latest value, call the Refresh method.

如果FileSystemInfo对象中描述的文件不存在, 则此属性返回12:00 年1月 1601 1 日午夜If the file described in the FileSystemInfo object does not exist, this property returns 12:00 midnight, January 1, 1601 A.D. 公元协调世界时 (UTC)。(C.E.) Coordinated Universal Time (UTC).

在不支持创建或出生时间的 Unix 平台上, 此属性将返回上次状态更改和上次修改时间的较早时间。On Unix platforms that do not support creation or birth time, this property returns the older of the time of the last status change and the time of the last modification. 在其他平台上, 它返回12:00 年1月1日午夜1601On other platforms, it returns 12:00 midnight, January 1, 1601 A.D. 公元协调世界时 (UTC), 调整为本地时间。(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

NTFS 格式的驱动器可能会在短时间内缓存文件元信息, 如文件创建时间。NTFS-formatted drives may cache file meta-info, such as file creation time, for a short period of time. 此过程称为文件隧道。This process is known as file tunneling. 因此, 如果要覆盖或替换现有文件, 可能需要显式设置文件的创建时间。As a result, it may be necessary to explicitly set the creation time of a file if you are overwriting or replacing an existing file.

安全性

FileIOPermission
用于设置创建时间。for setting the creation time. 关联的枚举:WriteAssociated enumeration: Write

适用于

另请参阅