File.GetCreationTimeUtc Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Überlädt

GetCreationTimeUtc(SafeFileHandle)	Gibt das Erstellungsdatum und die Uhrzeit der angegebenen Datei oder des angegebenen Verzeichnisses in koordinierter Weltzeit (UTC) zurück.
GetCreationTimeUtc(String)	Gibt das Erstellungsdatum und die Uhrzeit der angegebenen Datei oder des angegebenen Verzeichnisses in koordinierter Weltzeit (UTC) zurück.

GetCreationTimeUtc(SafeFileHandle)

Quelle:

File.cs

Gibt das Erstellungsdatum und die Uhrzeit der angegebenen Datei oder des angegebenen Verzeichnisses in koordinierter Weltzeit (UTC) zurück.

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

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

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

Public Shared Function GetCreationTimeUtc (fileHandle As SafeFileHandle) As DateTime

Parameter

fileHandle

SafeFileHandle

Eine SafeFileHandle für die Datei oder das Verzeichnis, für die Erstellungsdatums- und Uhrzeitinformationen abgerufen werden sollen.

Gibt zurück

DateTime

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

Ausnahmen

ArgumentNullException

fileHandle ist null.

UnauthorizedAccessException

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

GetCreationTimeUtc(String)

Quelle:

File.cs

Gibt das Erstellungsdatum und die Uhrzeit der angegebenen Datei oder des angegebenen Verzeichnisses in koordinierter Weltzeit (UTC) zurück.

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

public static DateTime GetCreationTimeUtc (string path);

static member GetCreationTimeUtc : string -> DateTime

Public Shared Function GetCreationTimeUtc (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

DateTime

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

Ausnahmen

UnauthorizedAccessException

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

ArgumentException

.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 mindestens ein ungültiges Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

ArgumentNullException

path ist null.

PathTooLongException

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

NotSupportedException

path weist ein ungültiges Format auf.

Beispiele

Das folgende Beispiel veranschaulicht die GetCreationTimeUtc Methode.

Imports System.IO

Module Module1

    Sub Main()
        Dim fileCreatedDate As DateTime = File.GetCreationTimeUtc("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.

Wenn die im path Parameter beschriebene Datei nicht vorhanden ist, gibt diese Methode am 1. Januar 1601 n. Januar 12:00 Uhr zurück. Koordinierte Weltzeit (UTC).

NTFS-formatierte Laufwerke können Informationen zu einer Datei, z. B. die Erstellungszeit der Datei, 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 allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• FileSystemWatcher
• Datei- und Stream-E/A
• Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei