File.GetLastWriteTimeUtc(String) Methode

  • Referenz

Definition

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

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.

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.

Gibt zurück

DateTime

Eine DateTime-Struktur, die auf das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei bzw. das angegebene Verzeichnis 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 vor 2.1: ist eine Zeichenfolge der Länge 0 (null), enthält nur Leerzeichen oder enthält mindestens ein path 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.

Hinweise

Hinweis

Diese Methode gibt möglicherweise einen ungenauen Wert zurück, da sie native Funktionen verwendet, deren Werte möglicherweise nicht kontinuierlich vom Betriebssystem aktualisiert werden. Jedes Betriebssystem verwaltet den Zeitpunkt des letzten Schreibzugriffs gemäß seinen eigenen Regeln. Um die Leistung zu verbessern, kann ein Betriebssystem den Wert der letzten Schreibzeit möglicherweise nicht auf den genauen Zeitpunkt des letzten Schreibvorganges festlegen, sondern stattdessen auf eine nahe Näherung festlegen.

Wenn die im -Parameter beschriebene Datei nicht vorhanden ist, gibt diese Methode path 12:00 Uhr Mitternacht, 1. Januar 1601 n. D. zurück. (C.E.) Koordinierte Weltzeit (UTC) verstrichen sind.

Der path -Parameter kann relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden als relativ zum aktuellen Arbeitsverzeichnis interpretiert. Informationen zum Abrufen des aktuellen Arbeitsverzeichnisses finden Sie unter GetCurrentDirectory .

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

Gilt für:

Siehe auch