File.GetLastWriteTimeUtc 方法

定义

重载

名称 说明
GetLastWriteTimeUtc(SafeFileHandle)

返回指定文件或目录的最后写入日期和时间(UTC)。

GetLastWriteTimeUtc(String)

返回指定文件或目录上次写入到的日期和时间(UTC)。

GetLastWriteTimeUtc(SafeFileHandle)

Source:
File.cs
Source:
File.cs
Source:
File.cs
Source:
File.cs
Source:
File.cs

返回指定文件或目录的最后写入日期和时间(UTC)。

public:
 static DateTime GetLastWriteTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);
public static DateTime GetLastWriteTimeUtc(Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);
static member GetLastWriteTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime
Public Shared Function GetLastWriteTimeUtc (fileHandle As SafeFileHandle) As DateTime

参数

fileHandle
SafeFileHandle

要获取上次写入日期和时间信息的文件或目录的 A SafeFileHandle

返回

一个 DateTime 结构设置为指定文件或目录的最后写入日期和时间。 此值以 UTC 时间表示。

例外

fileHandlenull

调用方没有所需的权限。

适用于

GetLastWriteTimeUtc(String)

Source:
File.cs
Source:
File.cs
Source:
File.cs
Source:
File.cs
Source:
File.cs

返回指定文件或目录上次写入到的日期和时间(UTC)。

public:
 static DateTime GetLastWriteTimeUtc(System::String ^ path);
public static DateTime GetLastWriteTimeUtc(string path);
static member GetLastWriteTimeUtc : string -> DateTime
Public Shared Function GetLastWriteTimeUtc (path As String) As DateTime

参数

path
String

要获取其写入日期和时间信息的文件或目录。

返回

一个 DateTime 结构设置为指定文件或目录上次写入到的日期和时间。 此值以 UTC 时间表示。

例外

调用方没有所需的权限。

低于 2.1 的 .NET Framework 和 .NET Core 版本: path 是长度为零的字符串,仅包含空格,或包含一个或多个无效字符。 可以使用该方法 GetInvalidPathChars() 查询无效字符。

pathnull

指定的路径、文件名或两者都超过了系统定义的最大长度。

path 格式无效。

注解

注释

此方法可能会返回不准确的值,因为它使用本机函数,其值可能不会由操作系统持续更新。 每个操作系统都根据自己的规则管理上次写入时间。 为了提高性能,操作系统可能不会将上次写入时间值设置为上次写入操作的确切时间,但可能会将其设置为接近近似值。

如果参数中描述的 path 文件不存在,此方法返回 1601 年 1 月 1 日午夜 12:00(C.E.)协调世界时(UTC)。

允许参数 path 指定相对路径或绝对路径信息。 相对路径信息解释为相对于当前工作目录。 若要获取当前工作目录,请参阅 GetCurrentDirectory

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于