File.GetLastAccessTimeUtc 方法

参考

定义

命名空间:: System.IO

程序集:: mscorlib.dll, System.IO.FileSystem.dll

程序集:: netstandard.dll, System.Runtime.dll

程序集:: netstandard.dll, System.IO.FileSystem.dll

程序集:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

程序集:: System.IO.FileSystem.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

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

重载

GetLastAccessTimeUtc(String)	返回上次访问指定文件或目录的日期和时间（UTC）。
GetLastAccessTimeUtc(SafeFileHandle)	返回指定文件或目录的最后一个访问日期和时间（UTC）。

GetLastAccessTimeUtc(String)

Source:: File.cs

Source:: File.cs

Source:: File.cs

返回上次访问指定文件或目录的日期和时间（UTC）。

public:
 static DateTime GetLastAccessTimeUtc(System::String ^ path);

public static DateTime GetLastAccessTimeUtc(string path);

static member GetLastAccessTimeUtc : string -> DateTime

Public Shared Function GetLastAccessTimeUtc (path As String) As DateTime

参数

path: String

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

DateTime

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

例外

UnauthorizedAccessException

调用方没有所需的权限。

ArgumentException

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

ArgumentNullException

path null。

PathTooLongException

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

NotSupportedException

path 格式无效。

注解

备注

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

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

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

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

另请参阅

适用于

.NET 10 和其他版本

产品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetLastAccessTimeUtc(SafeFileHandle)

Source:: File.cs

Source:: File.cs

Source:: File.cs

返回指定文件或目录的最后一个访问日期和时间（UTC）。

public:
 static DateTime GetLastAccessTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static DateTime GetLastAccessTimeUtc(Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetLastAccessTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime

Public Shared Function GetLastAccessTimeUtc (fileHandle As SafeFileHandle) As DateTime

参数

fileHandle: SafeFileHandle

要获取上次访问日期和时间信息的文件或目录的 SafeFileHandle。