File.GetLastAccessTime Метод

Определение

Пространство имен:
System.IO
Сборки:
netstandard.dll, System.Runtime.dll
Сборки:
mscorlib.dll, System.IO.FileSystem.dll
Сборки:
netstandard.dll, System.IO.FileSystem.dll
Сборки:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Сборка:
System.IO.FileSystem.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

Перегрузки

Имя Описание
GetLastAccessTime(SafeFileHandle)

Возвращает дату и время последнего доступа указанного файла или каталога.
GetLastAccessTime(String)

Возвращает дату и время последнего доступа к указанному файлу или каталогу.

GetLastAccessTime(SafeFileHandle)

Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
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

Вызывающий объект не имеет требуемого разрешения.

Применяется к

GetLastAccessTime(String)

Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
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 и .NET Core старше 2.1: path представляет собой строку нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().

ArgumentNullException

path равно null.

PathTooLongException

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

NotSupportedException

path имеет недопустимый формат.

Примеры

В следующем примере показано GetLastAccessTime.

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

Комментарии

Note

Этот метод может возвращать неточное значение, так как он использует собственные функции, значения которых не могут постоянно обновляться операционной системой.

Если файл, описанный в параметре path , не существует, этот метод возвращает 12:00 полуночи, 1 января 1601 года A.D. (C.E.) Координированное универсальное время (UTC), скорректированное на местное время.

Параметр path может указывать относительные или абсолютные сведения о пути. Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу. Чтобы получить текущий рабочий каталог, см. GetCurrentDirectory.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

Применяется к