File.GetCreationTime Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

GetCreationTime(SafeFileHandle)	Retourne l’heure de création du fichier ou du répertoire spécifié.
GetCreationTime(String)	Retourne la date/heure de création du fichier ou du répertoire spécifié.

GetCreationTime(SafeFileHandle)

Source:

File.cs

Retourne l’heure de création du fichier ou du répertoire spécifié.

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

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

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

Public Shared Function GetCreationTime (fileHandle As SafeFileHandle) As DateTime

Paramètres

fileHandle

SafeFileHandle

SafeFileHandle dans le fichier ou le répertoire pour lequel obtenir des informations de date et d’heure de création.

Retours

DateTime

Structure DateTime à laquelle sont assignées la date et l'heure de création du fichier ou du répertoire spécifié. Cette valeur est exprimée en heure locale.

Exceptions

ArgumentNullException

fileHandle a la valeur null.

UnauthorizedAccessException

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

GetCreationTime(String)

Source:

File.cs

Retourne la date/heure de création du fichier ou du répertoire spécifié.

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

public static DateTime GetCreationTime (string path);

static member GetCreationTime : string -> DateTime

Public Shared Function GetCreationTime (path As String) As DateTime

Paramètres

path

String

Fichier ou répertoire pour lequel obtenir les informations de date/heure de création.

Retours

DateTime

Structure DateTime à laquelle sont assignées la date et l'heure de création du fichier ou du répertoire spécifié. Cette valeur est exprimée en heure locale.

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.

Exemples

L’exemple suivant illustre GetCreationTime.

Imports System.IO

Module Module1

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

End Module

Remarques

Remarque

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.

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.

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), ajusté à l’heure locale.

Les lecteurs au format NTFS peuvent mettre en cache des informations sur un fichier, telles que l’heure de création du 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.

Voir aussi

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