File.SetLastAccessTime 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

重载

SetLastAccessTime(String, DateTime)	设置上次访问指定文件的日期和时间。
SetLastAccessTime(SafeFileHandle, DateTime)	设置上次访问指定文件或目录的日期和时间。

SetLastAccessTime(String, DateTime)

Source:

File.cs

设置上次访问指定文件的日期和时间。

public:
 static void SetLastAccessTime(System::String ^ path, DateTime lastAccessTime);

public static void SetLastAccessTime (string path, DateTime lastAccessTime);

static member SetLastAccessTime : string * DateTime -> unit

Public Shared Sub SetLastAccessTime (path As String, lastAccessTime As DateTime)

参数

path

String

要为其设置访问日期和时间信息的文件。

lastAccessTime

DateTime

一个 DateTime，包含为 path的最后一个访问日期和时间设置的值。 此值以本地时间表示。

例外

ArgumentException

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

ArgumentNullException

path null。

PathTooLongException

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

FileNotFoundException

找不到指定的路径。

UnauthorizedAccessException

调用方没有所需的权限。

NotSupportedException

path 格式无效。

ArgumentOutOfRangeException

lastAccessTime 指定超出此操作允许的日期或时间范围的值。

示例

以下示例检查文件系统中的指定文件、根据需要创建该文件，然后设置并获取上次访问时间。

using namespace System;
using namespace System::IO;
int main()
{
   try
   {
      String^ path = "c:\\Temp\\MyTest.txt";
      if (  !File::Exists( path ) )
      {
         File::Create( path );
         
         // Update the last access time.    
      }
      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);
                // Update the last access time.	
            }
            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

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

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

    // Update the last access time.
    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 dt = File.GetLastAccessTime path
    printfn $"The last access time for this file was {dt}."
with
| e -> printfn $"The process failed: {e}"

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 参数指定相对路径或绝对路径信息。 相对路径信息解释为相对于当前工作目录。 若要获取当前工作目录，请参阅 GetCurrentDirectory。

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

另请参阅

• FileSystemWatcher
• 文件和流 I/O
• 从文件 读取文本
• 如何：将文本写入文件

SetLastAccessTime(SafeFileHandle, DateTime)

Source:

File.cs

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

public:
 static void SetLastAccessTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime lastAccessTime);

public static void SetLastAccessTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime lastAccessTime);

static member SetLastAccessTime : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit

Public Shared Sub SetLastAccessTime (fileHandle As SafeFileHandle, lastAccessTime As DateTime)

参数

fileHandle

SafeFileHandle

要为其设置上次访问日期和时间信息的文件或目录的 SafeFileHandle。

lastAccessTime

DateTime

一个 DateTime，包含为 fileHandle的最后一个访问日期和时间设置的值。 此值以本地时间表示。

例外

ArgumentNullException

fileHandle null。

ArgumentOutOfRangeException

lastAccessTime 指定超出此操作允许的日期、时间或两者范围之外的值。

UnauthorizedAccessException

调用方没有所需的权限。

IOException

执行操作时发生 I/O 错误。