File.GetLastWriteTime Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

GetLastWriteTime(SafeFileHandle)	Retourne la date et l’heure d’écriture du fichier ou du répertoire spécifiés.
GetLastWriteTime(String)	Retourne la date et l’heure dans laquelle le fichier ou répertoire spécifié a été écrit pour la dernière fois.

GetLastWriteTime(SafeFileHandle)

Source:

File.cs

Retourne la date et l’heure d’écriture du fichier ou du répertoire spécifiés.

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

Un SafeFileHandle au fichier ou au 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 dernière date et l’heure d’écriture du fichier ou du répertoire spécifiés. Cette valeur est exprimée en heure locale.

Exceptions

ArgumentNullException

fileHandle est null.

UnauthorizedAccessException

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

GetLastWriteTime(String)

Source:

File.cs

Retourne la date et l’heure dans laquelle le fichier ou répertoire spécifié a été écrit pour la dernière fois.

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 des informations de date et d’heure d’écriture.

Retours

DateTime

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

Exceptions

UnauthorizedAccessException

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

ArgumentException

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

ArgumentNullException

path est null.

PathTooLongException

Le chemin d’accès spécifié, le nom de fichier ou les deux 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

Note

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

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

Le paramètre path 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 d’E/S courantes.

Voir aussi

• FileSystemWatcher
• fichier et flux d’E/S
• lecture de texte à partir d’un fichier
• Comment : écrire du texte dans un fichier