FileSystemInfo.CreationTime Propriété

Définition

Obtient ou définit l'heure de création du fichier ou du répertoire actif.Gets or sets the creation time of the current file or directory.

public:
 property DateTime CreationTime { DateTime get(); void set(DateTime value); };
public DateTime CreationTime { get; set; }
member this.CreationTime : DateTime with get, set
Public Property CreationTime As DateTime

Valeur de propriété

DateTime

Date et heure de création de l'objet FileSystemInfo actuel.The creation date and time of the current FileSystemInfo object.

Exceptions

Refresh() ne peut pas initialiser les données.Refresh() cannot initialize the data.

Le chemin spécifié n’est pas valide ; par exemple, il est sur un lecteur non mappé.The specified path is invalid; for example, it is on an unmapped drive.

Le système d’exploitation actuel n’est pas Windows NT ou version ultérieure.The current operating system is not Windows NT or later.

L’appelant essaie de définir un temps de création non valide.The caller attempts to set an invalid creation time.

Exemples

L’exemple suivant illustre la CreationTime propriété.The following example demonstrates the CreationTime property. Cet exemple de code fait partie d’un exemple plus complet fourni pour la FileSystemInfo classe.This code example is part of a larger example provided for the FileSystemInfo class.

static void DisplayFileSystemInfoAttributes(FileSystemInfo^ fsi)
{
    //  Assume that this entry is a file.
    String^ entryType = "File";

    // Determine if entry is really a directory
    if ((fsi->Attributes & FileAttributes::Directory) == FileAttributes::Directory)
    {
        entryType = "Directory";
    }
    //  Show this entry's type, name, and creation date.
    Console::WriteLine("{0} entry {1} was created on {2:D}", entryType, fsi->FullName, fsi->CreationTime);
}
static void DisplayFileSystemInfoAttributes(FileSystemInfo fsi)
{
    //  Assume that this entry is a file.
    string entryType = "File";

    // Determine if entry is really a directory
    if ((fsi.Attributes & FileAttributes.Directory) == FileAttributes.Directory )
    {
        entryType = "Directory";
    }
    //  Show this entry's type, name, and creation date.
    Console.WriteLine("{0} entry {1} was created on {2:D}", entryType, fsi.FullName, fsi.CreationTime);
}
Sub DisplayFileSystemInfoAttributes(ByVal fsi As IO.FileSystemInfo)
    ' Assume that this entry is a file.
    Dim entryType As String = "File"

    ' Determine if this entry is really a directory.
    If (fsi.Attributes And FileAttributes.Directory) = FileAttributes.Directory Then
        entryType = "Directory"
    End If

    ' Show this entry's type, name, and creation date.
    Console.WriteLine("{0} entry {1} was created on {2:D}", _
        entryType, fsi.FullName, fsi.CreationTime)
End Sub

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.This method may return an inaccurate value because it uses native functions whose values may not be continuously updated by the operating system.

La valeur de la CreationTime propriété est mise en cache préalablement si l’instance actuelle de l' FileSystemInfo objet a été retournée à partir de l’une des DirectoryInfo méthodes suivantes :The value of the CreationTime property is pre-cached if the current instance of the FileSystemInfo object was returned from any of the following DirectoryInfo methods:

Pour récupérer la valeur la plus récente, appelez la Refresh méthode.To get the latest value, call the Refresh method.

Si le fichier décrit dans l' FileSystemInfo objet n’existe pas, cette propriété retourne 12:00 minuit le 1er janvier 1601 apr. j.-c.If the file described in the FileSystemInfo object does not exist, this property returns 12:00 midnight, January 1, 1601 A.D. commune Temps universel coordonné (UTC, Universal Time Coordinated), ajusté à l’heure locale.(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

Sur les plateformes UNIX qui ne prennent pas en charge la création ou la durée de naissance, cette propriété retourne l’heure la plus ancienne de la dernière modification d’État et l’heure de la dernière modification.On Unix platforms that do not support creation or birth time, this property returns the older of the time of the last status change and the time of the last modification. Sur les autres plateformes, elle retourne 12:00 minuit le 1er janvier 1601 après J.-C.On other platforms, it returns 12:00 midnight, January 1, 1601 A.D. commune Temps universel coordonné (UTC, Universal Time Coordinated), ajusté à l’heure locale.(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

Les lecteurs au format NTFS peuvent mettre en cache les méta-informations de fichier, telles que l’heure de création du fichier, pendant une période de temps limitée.NTFS-formatted drives may cache file meta-info, such as file creation time, for a short period of time. Ce processus est appelé « tunneling de fichiers ».This process is known as file tunneling. 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.As a result, it may be necessary to explicitly set the creation time of a file if you are overwriting or replacing an existing file.

S’applique à

Voir aussi