File.GetLastWriteTimeUtc Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

GetLastWriteTimeUtc(SafeFileHandle)	Retourne la date et l’heure de la dernière écriture, en temps universel coordonné (UTC), du fichier ou répertoire spécifié.
GetLastWriteTimeUtc(String)	Retourne la date et l’heure, en temps universel coordonné (UTC), dans laquelle le fichier ou répertoire spécifié a été écrit pour la dernière fois.

GetLastWriteTimeUtc(SafeFileHandle)

Source:

File.cs

Retourne la date et l’heure de la dernière écriture, en temps universel coordonné (UTC), du fichier ou répertoire spécifié.

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

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

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

Public Shared Function GetLastWriteTimeUtc (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 temps UTC.

Exceptions

ArgumentNullException

fileHandle a la valeur null.

UnauthorizedAccessException

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

GetLastWriteTimeUtc(String)

Source:

File.cs

Retourne la date et l’heure, en temps universel coordonné (UTC), dans laquelle le fichier ou répertoire spécifié a été écrit pour la dernière fois.

public:
 static DateTime GetLastWriteTimeUtc(System::String ^ path);

public static DateTime GetLastWriteTimeUtc (string path);

static member GetLastWriteTimeUtc : string -> DateTime

Public Shared Function GetLastWriteTimeUtc (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 temps UTC.

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.

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).

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