File.SetLastAccessTime 方法

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

**命名空间:**System.IO
**程序集:**mscorlib（在 mscorlib.dll 中）

语法

声明
Public Shared Sub SetLastAccessTime ( _
    path As String, _
    lastAccessTime As DateTime _
)
用法
Dim path As String
Dim lastAccessTime As DateTime

File.SetLastAccessTime(path, lastAccessTime)

public static void SetLastAccessTime (
    string path,
    DateTime lastAccessTime
)

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

public static void SetLastAccessTime (
    String path, 
    DateTime lastAccessTime
)

public static function SetLastAccessTime (
    path : String, 
    lastAccessTime : DateTime
)

参数

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

• lastAccessTime
  DateTime，它包含要为 path 的上次访问日期和时间设置的值。该值用本地时间表示。

异常

异常类型	条件
ArgumentException	path 是一个零长度字符串，仅包含空白或者包含一个或多个由 InvalidPathChars 定义的无效字符。
ArgumentNullException	path 为 空引用（在 Visual Basic 中为 Nothing）。
PathTooLongException	指定的路径、文件名或者两者都超出了系统定义的最大长度。例如，在基于 Windows 的平台上，路径必须小于 248 个字符，文件名必须小于 260 个字符。
FileNotFoundException	未找到指定的路径。
UnauthorizedAccessException	调用方没有所要求的权限。
NotSupportedException	path 的格式无效。
ArgumentOutOfRangeException	lastAccessTime 指定超出该操作允许的日期或时间范围的值。

备注

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

有关使用此方法的示例，请参见“示例”部分。下表列出了其他典型或相关的 I/O 任务的示例。

若要执行此操作...	请参见本主题中的示例...
写入文本文件。	如何：向文件写入文本
读取文本文件。	如何：从文件读取文本
向文件中追加文本。	如何：打开并追加到日志文件 File.AppendText FileInfo.AppendText
重命名或移动文件。	File.Move FileInfo.MoveTo

示例

下面的示例检查文件系统中是否有指定的文件，如需要则创建该文件，然后设置并获取上次访问时间。

Imports System
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

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());
        }
    }
}

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 );
   }

}

import System.*;
import System.IO.*;

class Test
{
    public static void main(String[] args)
    {
        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.get_Now());
            dt = File.GetLastAccessTime(path);
            Console.WriteLine("The last access time for this file was {0}.",
                dt);
        }
        catch (System.Exception e) {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    } //main
} //Test

.NET Framework 安全性

• FileIOPermission  用于写入到指定的文件。关联的枚举：FileIOPermissionAccess.Write

平台

Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

File 类
File 成员
System.IO 命名空间

其他资源

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