Directory.GetLastWriteTime(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает дату и время последнего записи указанного файла или каталога.
public:
static DateTime GetLastWriteTime(System::String ^ path);
public static DateTime GetLastWriteTime(string path);
static member GetLastWriteTime : string -> DateTime
Public Shared Function GetLastWriteTime (path As String) As DateTime
Параметры
- path
- String
Файл или каталог, для которого необходимо получить сведения о дате и времени изменения.
Возвращаемое значение
Структура, заданная в дату и время последнего записи указанного файла или каталога. Это значение выражается в локальном времени.
Исключения
Вызывающий объект не имеет требуемого разрешения.
Версии .NET Framework и .NET Core старше 2.1: path представляет собой строку нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы с GetInvalidPathChars() помощью метода.
path равно null.
Указанный путь, имя файла или оба превышают определенную системой максимальную длину.
Примеры
В следующем примере показано, как использовать GetLastWriteTime.
using System;
using System.IO;
class Test
{
public static void Main()
{
try
{
string path = @"c:\MyDir";
if (!Directory.Exists(path))
{
Directory.CreateDirectory(path);
}
else
{
// Take an action which will affect the write time.
Directory.SetLastWriteTime(path, new DateTime(1985,4,3));
}
// Get the creation time of a well-known directory.
DateTime dt = Directory.GetLastWriteTime(path);
Console.WriteLine("The last write time for this directory was {0}", dt);
// Update the last write time.
Directory.SetLastWriteTime(path, DateTime.Now);
dt = Directory.GetLastWriteTime(path);
Console.WriteLine("The last write time for this directory was {0}", dt);
}
catch (Exception e)
{
Console.WriteLine("The process failed: {0}", e.ToString());
}
}
}
open System
open System.IO
try
let path = @"c:\MyDir"
if not (Directory.Exists path) then
Directory.CreateDirectory path |> ignore
else
// Take an action which will affect the write time.
Directory.SetLastWriteTime(path, DateTime(1985, 4, 3))
// Get the creation time of a well-known directory.
let dt = Directory.GetLastWriteTime path
printfn $"The last write time for this directory was {dt}"
// Update the last write time.
Directory.SetLastWriteTime(path, DateTime.Now)
let dt = Directory.GetLastWriteTime path
printfn $"The last write time for this directory was {dt}"
with e ->
printfn $"The process failed: {e}"
Imports System.IO
Public Class Test
Public Shared Sub Main()
Try
Dim path As String = "c:\MyDir"
If Directory.Exists(path) = False Then
Directory.CreateDirectory(path)
Else
' Take an action which will affect the write time.
Directory.SetLastWriteTime(path, New DateTime(1985, 4, 3))
End If
' Get the creation time of a well-known directory.
Dim dt As DateTime = Directory.GetLastWriteTime(path)
Console.WriteLine("The last write time for this directory was {0}", dt)
' Update the last write time.
Directory.SetLastWriteTime(path, DateTime.Now)
dt = Directory.GetLastWriteTime(path)
Console.WriteLine("The last write time for this directory 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.
Конфиденциальность регистра path параметра соответствует файловой системе, в которой выполняется код. Например, это не учитывает регистр в NTFS (файловая система Windows по умолчанию) и учитывает регистр в файловых системах Linux.
Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.