File.GetLastWriteTimeUtc(String) Methode

Definition

Gibt das Datum und den Zeitpunkt des letzten Schreibzugriffs auf die angegebenen Datei bzw. das angegebene Verzeichnis im UTC-Format (Coordinated Universal Time) zurück.Returns the date and time, in coordinated universal time (UTC), that the specified file or directory was last written to.

public:
 static DateTime GetLastWriteTimeUtc(System::String ^ path);
public static DateTime GetLastWriteTimeUtc (string path);
static member GetLastWriteTimeUtc : string -> DateTime
Public Shared Function GetLastWriteTimeUtc (path As String) As DateTime

Parameter

path
String

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

Gibt zurück

Eine DateTime-Struktur, die auf das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei bzw. das angegebene Verzeichnis festgelegt wird.A DateTime structure set to the date and time that the specified file or directory was last written to. 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.

path ist null.path is null.

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.

Hinweise

Hinweis

Diese Methode gibt möglicherweise einen ungenauen Wert zurück, da Sie Native Funktionen verwendet, deren Werte nicht fortlaufend vom Betriebssystem aktualisiert werden.This method may return an inaccurate value, because it uses native functions whose values may not be continuously updated by the operating system. Jedes Betriebssystem verwaltet den Zeitpunkt des letzten Schreibzugriffs gemäß seinen eigenen Regeln.Each operating system manages the last write time according to its own rules. Um die Leistung zu verbessern, legt ein Betriebssystem möglicherweise nicht den Wert für die letzte Schreibzeit auf die genaue Zeit des letzten Schreibvorgangs fest, sondern kann stattdessen eine genaue Näherung festlegen.To improve performance, an operating system might not set the last write time value to the exact time of the last write operation, but might set it to a close approximation instead.

Wenn die im path-Parameter beschriebene Datei nicht vorhanden ist, gibt diese Methode 12:00 Mitternacht, 1. Januar 1601 n. Chr. zurück.If the file described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. (C.E. = Common Era, aktuelle Zeitrechnung) koordinierter Weltzeit (UTC).(C.E.) Coordinated Universal Time (UTC).

Der path-Parameter darf relative oder absolute Pfadinformationen angeben.The path parameter is permitted to specify relative or absolute path information. Relative Pfadinformationen werden als relativ zum aktuellen Arbeitsverzeichnis interpretiert.Relative path information is interpreted as relative to the current working directory. Informationen zum Abrufen des aktuellen Arbeitsverzeichnisses finden Sie unter GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine 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. Zugehörige Enumeration: ReadAssociated enumeration: Read

Gilt für:

Siehe auch