File.GetLastAccessTime 方法

参考

定义

命名空间:: System.IO

程序集:: System.Runtime.dll

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

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

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

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

重载

GetLastAccessTime(SafeFileHandle)	返回指定文件或目录的上次访问日期和时间。
GetLastAccessTime(String)	返回上次访问指定文件或目录的日期和时间。

GetLastAccessTime(SafeFileHandle)

Source:: File.cs

Source:: File.cs

Source:: File.cs

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

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

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

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

Public Shared Function GetLastAccessTime (fileHandle As SafeFileHandle) As DateTime

参数

fileHandle: SafeFileHandle

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

DateTime

一个 DateTime 结构，设置为指定文件或目录的上次访问日期和时间。该值用本地时间表示。

例外

ArgumentNullException

fileHandle 为 null。

UnauthorizedAccessException

调用方没有所要求的权限。

适用于

.NET 9 和其他版本

产品	版本
.NET	7, 8, 9

GetLastAccessTime(String)

Source:: File.cs

Source:: File.cs

Source:: File.cs

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

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

public static DateTime GetLastAccessTime (string path);

static member GetLastAccessTime : string -> DateTime

Public Shared Function GetLastAccessTime (path As String) As DateTime

参数

path: String

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

DateTime

一个 DateTime 结构，它被设置为上次访问指定文件或目录的日期和时间。该值用本地时间表示。

例外

UnauthorizedAccessException

调用方没有所要求的权限。

ArgumentException

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

ArgumentNullException

path 为 null。

PathTooLongException

指定的路径和/或文件名超过了系统定义的最大长度。

NotSupportedException

path 的格式无效。

示例

以下示例演示 GetLastAccessTime。

using namespace System;
using namespace System::IO;
int main()
{
   try
   {
      String^ path = "c:\\Temp\\MyTest.txt";
      if (  !File::Exists( path ) )
      {
         File::Create( path );
      }
      File::SetLastAccessTime( path, DateTime(1985,5,4) );
      
      // Get the creation time of a well-known directory.
      DateTime dt = File::GetLastAccessTime( path );
      Console::WriteLine( "The last access time for this file was {0}.", dt );
      
      // Update the last access time.
      File::SetLastAccessTime( path, DateTime::Now );
      dt = File::GetLastAccessTime( path );
      Console::WriteLine( "The last access time for this file was {0}.", dt );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }

}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            string path = @"c:\Temp\MyTest.txt";

            if (!File.Exists(path))
            {
                File.Create(path);
            }
            File.SetLastAccessTime(path, new DateTime(1985,5,4));

            // Get the creation time of a well-known directory.
            DateTime dt = File.GetLastAccessTime(path);
            Console.WriteLine("The last access time for this file was {0}.", dt);
            
            // Update the last access time.
            File.SetLastAccessTime(path, DateTime.Now);
            dt = File.GetLastAccessTime(path);
            Console.WriteLine("The last access time for this file was {0}.", dt);
        }

        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

open System
open System.IO

let path = @"c:\Temp\MyTest.txt"

if File.Exists path |> not then
    File.Create path |> ignore

File.SetLastAccessTime(path, DateTime(1985, 5, 4))

// Get the creation time of a well-known directory.
let dt = File.GetLastAccessTime path
printfn $"The last access time for this file was {dt}."

// Update the last access time.
File.SetLastAccessTime(path, DateTime.Now)
let dt2 = File.GetLastAccessTime path
printfn $"The last access time for this file was {dt2}."

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Try
            Dim path As String = "c:\Temp\MyTest.txt"
            If File.Exists(path) = False Then
                File.Create(path)
            End If
            File.SetLastAccessTime(path, New DateTime(1985, 5, 4))

            ' Get the creation time of a well-known directory.
            Dim dt As DateTime = File.GetLastAccessTime(path)

            Console.WriteLine("The last access time for this file was {0}.", dt)

            ' Update the last access time.
            File.SetLastAccessTime(path, DateTime.Now)
            dt = File.GetLastAccessTime(path)
            Console.WriteLine("The last access time for this file was {0}.", dt)

        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

注解

备注

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

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

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

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

另请参阅

适用于

.NET 9 和其他版本

产品	版本
.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
.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

通过

File.GetLastAccessTime 方法

定义

重载

GetLastAccessTime(SafeFileHandle)

参数

返回

例外

适用于

GetLastAccessTime(String)

参数

返回

例外

示例

注解

另请参阅

适用于

其他资源