Прочитать на английском

Поделиться через


File.GetLastAccessTime Метод

Определение

Перегрузки

GetLastAccessTime(SafeFileHandle)

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

GetLastAccessTime(String)

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

GetLastAccessTime(SafeFileHandle)

Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs

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

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

Параметры

fileHandle
SafeFileHandle

Объект SafeFileHandle для файла или каталога, для которого необходимо получить сведения о дате и времени последнего доступа.

Возвращаемое значение

Для DateTime структуры заданы дата и время последнего доступа к указанному файлу или каталогу. Значение представляется в формате местного времени.

Исключения

fileHandle имеет значение null.

У вызывающего объекта отсутствует необходимое разрешение.

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

.NET 9 и другие версии
Продукт Версии
.NET 7, 8, 9

GetLastAccessTime(String)

Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs

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

C#
public static DateTime GetLastAccessTime (string path);

Параметры

path
String

Файл или каталог, информацию о дате и времени обращения к которому следует получить.

Возвращаемое значение

Структура DateTime, для которой заданы дата и время последнего доступа к указанному файлу или каталогу. Значение представляется в формате местного времени.

Исключения

У вызывающего объекта отсутствует необходимое разрешение.

платформа .NET Framework и .NET Core версий старше 2.1: path строка нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().

path имеет значение null.

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

Параметр path задан в недопустимом формате.

Примеры

В следующем примере демонстрируется GetLastAccessTime.

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

Комментарии

Примечание

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

Если файл, описанный в параметре path , не существует, этот метод возвращает 12:00 полночь 1 января 1601 г. н.э. Время в формате UTC с учетом местного времени.

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

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

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

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

.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