File.GetCreationTimeUtc Methode

Definition

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

Überlädt

Name Beschreibung
GetCreationTimeUtc(SafeFileHandle)

Gibt das Erstellungsdatum und die Uhrzeit in utc (Coordinated Universal Time) der angegebenen Datei oder des angegebenen Verzeichnisses zurück.
GetCreationTimeUtc(String)

Gibt das Erstellungsdatum und die Uhrzeit in utc (Coordinated Universal Time) der angegebenen Datei oder des angegebenen Verzeichnisses zurück.

GetCreationTimeUtc(SafeFileHandle)

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

Gibt das Erstellungsdatum und die Uhrzeit in utc (Coordinated Universal Time) der angegebenen Datei oder des angegebenen Verzeichnisses 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

A SafeFileHandle für die Datei oder das Verzeichnis, für die Datums- und Uhrzeitinformationen zum Erstellen verwendet werden sollen.

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 UTC-Zeit ausgedrückt.

Ausnahmen

ArgumentNullException

fileHandle ist null.

UnauthorizedAccessException

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

Gilt für:

GetCreationTimeUtc(String)

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

Gibt das Erstellungsdatum und die Uhrzeit in utc (Coordinated Universal Time) der angegebenen Datei oder des angegebenen Verzeichnisses 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 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 UTC-Zeit 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

Im folgenden Beispiel wird die GetCreationTimeUtc Methode veranschaulicht.

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

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.

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).

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".

Weitere Informationen

Gilt für: