File.GetLastWriteTimeUtc(String) Méthode

Définition

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

Retours

Structure DateTime 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 UTC.

Exceptions

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

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

path a la valeur null.

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.

path est dans un format non valide.

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

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 d’E/S courantes.

S’applique à

Voir aussi