File.GetCreationTimeUtc(String) File.GetCreationTimeUtc(String) File.GetCreationTimeUtc(String) File.GetCreationTimeUtc(String) Method

Definition

Gibt das Erstellungsdatum und den Erstellungszeitpunkt der angegebenen Datei bzw. des angegebenen Verzeichnisses im UTC-Format (Coordinated Universal Time) zurück.Returns the creation date and time, in coordinated universal time (UTC), of the specified file or directory.

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 String String String

Die Datei oder das Verzeichnis, für die bzw. für das die Informationen über Erstellungsdatum und -zeitpunkt abgerufen werden sollen.The file or directory for which to obtain creation date and time information.

Gibt zurück

Eine DateTime-Struktur, die auf das Erstellungsdatum und den Erstellungszeitpunkt für das angegebene Verzeichnis oder die angegebene Datei festgelegt wird.A DateTime structure set to the creation date and time for the specified file or directory. Der Wert wird in UTC-Zeit angegeben.This value is expressed in UTC time.

Ausnahmen

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder mindestens ein ungültiges Zeichen gemäß der Definition von InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

path weist ein ungültiges Format auf.path is in an invalid format.

Beispiele

Das folgende Beispiel veranschaulicht die GetCreationTimeUtc Methode.The following example demonstrates the GetCreationTimeUtc method.

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 kann einen fehlerhaften Wert, zurück, da sie systemeigene Funktionen verwendet, deren Werte nicht kontinuierlich durch das Betriebssystem aktualisiert werden können.This method may return an inaccurate value, because it uses native functions whose values may not be continuously updated by the operating system.

Wenn in die Datei beschrieben die path Parameter ist nicht vorhanden, diese Methode gibt zurück, 0:00 Uhr, 1. Januar 1601 n. Chr.If the file described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Koordinierte Weltzeit (UTC).(C.E.) Coordinated Universal Time (UTC).

NTFS-formatierten Laufwerken können es sich um Informationen zu einer Datei, z. B. die Erstellungszeit der Datei für einen kurzen Zeitraum zwischenspeichern.NTFS-formatted drives may cache information about a file, such as file creation time, for a short period of time. Daher ist es möglicherweise notwendig, den Zeitpunkt der Erstellung einer Datei explizit festlegen, wenn Sie überschreiben oder Ersetzen eine vorhandene Datei.As a result, it may be necessary to explicitly set the creation time of a file if you are overwriting or replacing an existing file.

Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Sicherheit

FileIOPermission
zum Lesen aus der angegebenen Datei.for reading from the specified file. Zugeordnete Enumeration: ReadAssociated enumeration: Read

Gilt für:

Siehe auch