File.GetCreationTimeUtc(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 de création, en temps universel coordonné (UTC), du fichier ou du répertoire spécifié.

public:
 static DateTime GetCreationTimeUtc(System::String ^ path);
public static DateTime GetCreationTimeUtc(string path);
static member GetCreationTimeUtc : string -> DateTime
Public Shared Function GetCreationTimeUtc (path As String) As DateTime

Paramètres

path
String

Fichier ou répertoire pour lequel obtenir des informations de date et d’heure de création.

Retours

DateTime

Structure DateTime définie sur la date et l’heure de création du fichier ou du répertoire spécifiés. Cette valeur est exprimée en heure UTC.

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

NotSupportedException

path est dans un format non valide.

Exemples

L’exemple suivant illustre la GetCreationTimeUtc méthode.

Imports System.IO

Module Module1

    Sub Main()
        Dim fileCreatedDate As DateTime = File.GetCreationTimeUtc("C:\Example\MyTest.txt")
        Console.WriteLine("file created: " + fileCreatedDate)
    End Sub

End Module

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

Les lecteurs au format NTFS peuvent mettre en cache des informations sur un fichier, telles que l’heure de création de fichier, pendant une courte période. Par conséquent, il peut être nécessaire de définir explicitement l’heure de création d’un fichier si vous remplacez ou remplacez un fichier existant.

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

S’applique à

Voir aussi