File.SetLastWriteTime Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

SetLastWriteTime(SafeFileHandle, DateTime)	Définit la date et l’heure auxquelles le fichier ou répertoire spécifié a été écrit pour la dernière fois.
SetLastWriteTime(String, DateTime)	Définit la date/heure du dernier accès en écriture au fichier spécifié.

SetLastWriteTime(SafeFileHandle, DateTime)

Source:

File.cs

Définit la date et l’heure auxquelles le fichier ou répertoire spécifié a été écrit pour la dernière fois.

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)

Paramètres

fileHandle

SafeFileHandle

SafeFileHandle dans le fichier ou le répertoire pour lequel définir les dernières informations de date et d’heure d’écriture.

lastWriteTime

DateTime

Élément DateTime contenant la valeur à affecter pour la date/heure du dernier accès en écriture à fileHandle. Cette valeur est exprimée en heure locale.

Exceptions

ArgumentNullException

fileHandle a la valeur null.

ArgumentOutOfRangeException

lastWriteTime spécifie une valeur en dehors de la plage de dates et/ou d’heures autorisées pour cette opération.

UnauthorizedAccessException

L'appelant n'a pas l'autorisation requise.

IOException

Une erreur d’E/S s’est produite pendant l’opération.

SetLastWriteTime(String, DateTime)

Source:

File.cs

Définit la date/heure du dernier accès en écriture au fichier spécifié.

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)

Paramètres

path

String

Fichier pour lequel définir les informations de date/heure.

lastWriteTime

DateTime

Élément DateTime contenant la valeur à affecter pour la date/heure du dernier accès en écriture à path. Cette valeur est exprimée en heure locale.

Exceptions

ArgumentException

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

ArgumentNullException

path a la valeur null.

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

FileNotFoundException

Le chemin spécifié est introuvable.

UnauthorizedAccessException

L'appelant n'a pas l'autorisation requise.

NotSupportedException

path est dans un format non valide.

ArgumentOutOfRangeException

lastWriteTime spécifie une valeur qui n’est pas comprise dans la plage de dates ou d’heures autorisées pour cette opération.

Exemples

L’exemple suivant vérifie le système de fichiers pour le fichier spécifié, en créant le fichier si nécessaire, puis définit et obtient l’heure de la dernière écriture du fichier.

using namespace System;
using namespace System::IO;
int 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, 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 );
   }

}

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

Remarques

Le path paramètre est autorisé à spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

• FileSystemWatcher
• Fichier et flux de données E/S
• Lecture de texte à partir d’un fichier
• Procédure : écrire du texte dans un fichier