File.SetLastWriteTime Метод

Определение

Пространство имен:

System.IO

Сборки:

netstandard.dll, System.Runtime.dll

Перегрузки

Имя	Описание
SetLastWriteTime(SafeFileHandle, DateTime)	Задает дату и время последнего записи указанного файла или каталога.
SetLastWriteTime(String, DateTime)	Задает дату и время последнего записи указанного файла.

SetLastWriteTime(SafeFileHandle, DateTime)

Исходный код:

File.cs

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

public:
 static void SetLastWriteTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime lastWriteTime);

public static void SetLastWriteTime(Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime lastWriteTime);

static member SetLastWriteTime : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit

Public Shared Sub SetLastWriteTime (fileHandle As SafeFileHandle, lastWriteTime As DateTime)

Параметры

fileHandle

SafeFileHandle

Файл SafeFileHandle или каталог, для которого необходимо задать последние сведения о дате и времени записи.

lastWriteTime

DateTime

Значение DateTime , указывающее дату и время fileHandleпоследней записи. Это значение выражается в локальном времени.

Исключения

ArgumentNullException

fileHandle равно null.

ArgumentOutOfRangeException

lastWriteTime указывает значение вне диапазона дат, времени или обоих разрешенных для этой операции.

UnauthorizedAccessException

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

IOException

При выполнении операции произошла ошибка ввода-вывода.

SetLastWriteTime(String, DateTime)

Исходный код:

File.cs

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

public:
 static void SetLastWriteTime(System::String ^ path, DateTime lastWriteTime);

public static void SetLastWriteTime(string path, DateTime lastWriteTime);

static member SetLastWriteTime : string * DateTime -> unit

Public Shared Sub SetLastWriteTime (path As String, lastWriteTime As DateTime)

Параметры

path

String

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

lastWriteTime

DateTime

Значение DateTime , указывающее дату и время pathпоследней записи. Это значение выражается в локальном времени.

Исключения

ArgumentException

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

ArgumentNullException

path равно null.

PathTooLongException

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

FileNotFoundException

Указанный путь не найден.

UnauthorizedAccessException

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

NotSupportedException

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

ArgumentOutOfRangeException

lastWriteTime указывает значение вне диапазона дат или времени, разрешенных для этой операции.

Примеры

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

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);
            }
            else
            {
                // Take an action that will affect the write time.
                File.SetLastWriteTime(path, new DateTime(1985,4,3));
            }

            // Get the creation time of a well-known directory.
            DateTime dt = File.GetLastWriteTime(path);
            Console.WriteLine("The last write time for this file was {0}.", dt);
            
            // Update the last write time.
            File.SetLastWriteTime(path, DateTime.Now);
            dt = File.GetLastWriteTime(path);
            Console.WriteLine("The last write time for this file was {0}.", dt);
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

open System
open System.IO

try
    let path = @"c:\Temp\MyTest.txt"

    if File.Exists path |> not then
        File.Create path |> ignore
    else
        // Take an action that will affect the write time.
        File.SetLastWriteTime(path, DateTime(1985, 4, 3))

    // Get the creation time of a well-known directory.
    let dt = File.GetLastWriteTime path
    printfn $"The last write time for this file was {dt}."

    // Update the last write time.
    File.SetLastWriteTime(path, DateTime.Now)
    let dt = File.GetLastWriteTime path
    printfn $"The last write time for this file was {dt}."
with
| e -> printfn $"The process failed: {e}"

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)
            Else
                ' Take an action that will affect the write time.
                File.SetLastWriteTime(path, New DateTime(1985, 4, 3))
            End If

            ' Get the creation time of a well-known directory.
            Dim dt As DateTime = File.GetLastWriteTime(path)
            Console.WriteLine("The last write time for this file was {0}.", dt)

            ' Update the last write time.
            File.SetLastWriteTime(path, DateTime.Now)
            dt = File.GetLastWriteTime(path)
            Console.WriteLine("The last write 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

Комментарии

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

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

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

• FileSystemWatcher
• Файловый и потоковый ввод-вывод
• чтение текста из файла
• Практическое руководство. Запись текста в файл