File.GetCreationTime(String) Methode

Definition

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

Gibt das Erstellungsdatum und die Uhrzeit der angegebenen Datei oder des angegebenen Verzeichnisses zurück.

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

Parameter

path
String

Die Datei oder das Verzeichnis, für die Erstellungsdatums- und Uhrzeitinformationen abzurufen sind.

Gibt zurück

DateTime

Eine DateTime Struktur, die auf das Erstellungsdatum und die Uhrzeit für die angegebene Datei oder das angegebene Verzeichnis festgelegt ist. Dieser Wert wird in der Ortszeit ausgedrückt.

Ausnahmen

UnauthorizedAccessException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars() Methode abfragen.

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.

NotSupportedException

path ist in einem ungültigen Format vorhanden.

Beispiele

Das folgende Beispiel veranschaulicht 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

Hinweise

Note

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

Der path Parameter darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert. Informationen zum Abrufen des aktuellen Arbeitsverzeichnisses finden Sie unter GetCurrentDirectory.

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

NTFS-formatierte Laufwerke können Informationen zu einer Datei zwischenspeichern, z. B. die Zeit zum Erstellen von Dateien, für einen kurzen Zeitraum. Daher kann es erforderlich sein, die Erstellungszeit einer Datei explizit festzulegen, wenn Sie eine vorhandene Datei überschreiben oder ersetzen.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Gilt für:

Weitere Informationen