FileSystemInfo.CreationTime Eigenschaft

  • Referenz

Definition

Namespace:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Ruft den Erstellungszeitpunkt der aktuellen Datei oder des aktuellen Verzeichnisses ab oder legt diesen fest.

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

Eigenschaftswert

DateTime

Das Erstellungsdatum und die Erstellungszeit des aktuellen FileSystemInfo-Objekts.

Ausnahmen

IOException

Refresh() kann die Daten nicht initialisieren.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig. Zum Beispiel befindet er sich auf einem nicht zugeordneten Laufwerk.

PlatformNotSupportedException

Das aktuelle Betriebssystem ist nicht Windows NT oder höher.

ArgumentOutOfRangeException

Der Aufrufer versucht, eine ungültige Erstellungszeit festzulegen.

Beispiele

Im folgenden Beispiel wird die CreationTime Eigenschaft veranschaulicht. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die FileSystemInfo-Klasse bereitgestellt wird.

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

Hinweise

Hinweis

Diese Methode kann einen ungenauen Wert zurückgeben, da sie systemeigene Funktionen verwendet, deren Werte möglicherweise nicht kontinuierlich vom Betriebssystem aktualisiert werden.

Der Wert der CreationTime Eigenschaft wird vorab zwischengespeichert, wenn die aktuelle Instanz des FileSystemInfo Objekts von einer der folgenden DirectoryInfo Methoden zurückgegeben wurde:

Rufen Sie die Refresh Methode auf, um den neuesten Wert abzurufen.

Wenn die im FileSystemInfo Objekt beschriebene Datei nicht vorhanden ist, gibt diese Eigenschaft 12:00 Mitternacht, 1. Januar 1601 A.D. zurück. (C.E.) Koordinierte Weltzeit (UTC), angepasst an die Ortszeit.

Auf Unix-Plattformen, die die Erstellungs- oder Geburtszeit nicht unterstützen, gibt diese Eigenschaft die ältere Zeit der letzten Statusänderung und die Uhrzeit der letzten Änderung zurück. Auf anderen Plattformen gibt es 12:00 Mitternacht, 1. Januar 1601 A.D. zurück. (C.E.) Koordinierte Weltzeit (UTC), angepasst an die Ortszeit.

NTFS-formatierte Laufwerke können Dateimetainformationen, z. B. dateierstellungszeit, für einen kurzen Zeitraum zwischenspeichern. Dieser Prozess wird als Dateitunnelung bezeichnet. Daher kann es erforderlich sein, die Erstellungszeit einer Datei explizit festzulegen, wenn Sie eine vorhandene Datei überschreiben oder ersetzen.

Gilt für

Siehe auch