Directory.GetLastWriteTime(String) Méthode

Définition

Espace de noms:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
netstandard.dll

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 de modification.

Retours

DateTime

Structure définie sur la date et l’heure dans laquelle 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 avec la GetInvalidPathChars() méthode.

ArgumentNullException

path a la valeur 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.

Exemples

L’exemple suivant montre comment utiliser 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

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.

Si le répertoire décrit dans le path paramètre 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 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.

La sensibilité de la casse du path paramètre correspond à celle du système de fichiers sur lequel le code est en cours d’exécution. Par exemple, il ne respecte pas la casse sur NTFS (le système de fichiers Windows par défaut) et respecte la casse sur les systèmes de fichiers Linux.

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

S’applique à

Voir aussi