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

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


File.GetLastWriteTimeUtc Метод

Определение

Перегрузки

GetLastWriteTimeUtc(SafeFileHandle)

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

GetLastWriteTimeUtc(String)

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

GetLastWriteTimeUtc(SafeFileHandle)

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

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

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

Параметры

fileHandle
SafeFileHandle

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

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

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

Исключения

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

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

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

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

GetLastWriteTimeUtc(String)

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

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

C#
public static DateTime GetLastWriteTimeUtc (string path);

Параметры

path
String

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

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

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

Исключения

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

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

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

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

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

Комментарии

Примечание

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

Если файл, описанный в параметре path , не существует, этот метод возвращает 12:00 полночь 1 января 1601 г. н.э. (C.E.) Время в формате 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