Freigeben über


File.GetCreationTime Methode

Definition

Überlädt

GetCreationTime(SafeFileHandle)

Gibt die Erstellungszeit der angegebenen Datei oder des angegebenen Verzeichnisses zurück.

GetCreationTime(String)

Gibt das Erstellungsdatum und den Erstellungszeitpunkt für die angegebene Datei bzw. das angegebene Verzeichnis zurück.

GetCreationTime(SafeFileHandle)

Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Gibt die Erstellungszeit der angegebenen Datei oder des angegebenen Verzeichnisses zurück.

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

Parameter

fileHandle
SafeFileHandle

Ein SafeFileHandle für die Datei oder das Verzeichnis, für die Datums- und Uhrzeitinformationen zur Erstellung abgerufen werden sollen.

Gibt zurück

Eine DateTime-Struktur, die auf das Erstellungsdatum und den Erstellungszeitpunkt für das angegebene Verzeichnis oder die angegebene Datei festgelegt wird. Dieser Wert wird in Ortszeit angegeben.

Ausnahmen

fileHandle ist null.

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

Gilt für:

GetCreationTime(String)

Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Gibt das Erstellungsdatum und den Erstellungszeitpunkt für die angegebene Datei bzw. das angegebene Verzeichnis 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 bzw. für das die Informationen über Erstellungsdatum und -zeitpunkt abgerufen werden sollen.

Gibt zurück

Eine DateTime-Struktur, die auf das Erstellungsdatum und den Erstellungszeitpunkt für das angegebene Verzeichnis oder die angegebene Datei festgelegt wird. Dieser Wert wird in Ortszeit angegeben.

Ausnahmen

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

.NET Framework und .NET Core-Versionen älter als 2.1: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

path ist null.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

path weist ein ungültiges Format auf.

Beispiele

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

Hinweis

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 um 12:00 Uhr am 1. Januar 1601 n. Chr. (C.E.) zurück. Koordinierte Weltzeit (UTC), angepasst an die Ortszeit.

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

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für: