File.GetLastWriteTime Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

GetLastWriteTime(String)	Retourne la date/heure du dernier accès en écriture au fichier ou au répertoire spécifié.
GetLastWriteTime(SafeFileHandle)	Retourne la date et l’heure de la dernière écriture du fichier ou répertoire spécifié.

GetLastWriteTime(String)

Source:

File.cs

Retourne la date/heure du dernier accès en écriture au fichier ou au répertoire spécifié.

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

Paramètres

path

String

Fichier ou répertoire pour lequel obtenir les informations de date/heure d'accès en écriture.

Retours

DateTime

Structure DateTime ayant pour valeur la date et l'heure de la dernière écriture dans le fichier ou le répertoire spécifié. Cette valeur est exprimée en heure locale.

Exceptions

UnauthorizedAccessException

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

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.

NotSupportedException

path est dans un format non valide.

Exemples

L’exemple suivant illustre GetLastWriteTime.

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

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 dt2 = File.GetLastWriteTime path
printfn $"The last write time for this file was {dt2}."

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 some 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

Notes

Cette méthode peut retourner une valeur inexacte, car elle utilise des fonctions natives dont les valeurs ne peuvent pas être mises à jour en continu par le système d’exploitation. Chaque système d’exploitation gère l’heure de la dernière écriture selon ses propres règles. Pour améliorer les performances, un système d’exploitation peut ne pas définir la valeur de l’heure de la dernière écriture sur l’heure exacte de la dernière opération d’écriture, mais peut la définir sur une approximation proche à la place.

Si le fichier décrit dans le path paramètre n’existe pas, cette méthode retourne 12 :00 minuit, le 1er janvier 1601 (C.E.) Temps universel coordonné (UTC), ajusté à l’heure locale.

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

GetLastWriteTime(SafeFileHandle)

Source:

File.cs

Retourne la date et l’heure de la dernière écriture du fichier ou répertoire spécifié.

public:
 static DateTime GetLastWriteTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static DateTime GetLastWriteTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetLastWriteTime : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime

Public Shared Function GetLastWriteTime (fileHandle As SafeFileHandle) As DateTime

Paramètres

fileHandle

SafeFileHandle

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

Retours

DateTime

Structure DateTime définie sur la date et l’heure de la dernière écriture pour le fichier ou répertoire spécifié. Cette valeur est exprimée en heure locale.

Exceptions

ArgumentNullException

fileHandle a la valeur null.

UnauthorizedAccessException

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