File.SetCreationTimeUtc Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
SetCreationTimeUtc(String, DateTime) |
Legt das Datum und die Uhrzeit in koordinierter Weltzeit (UTC) fest, das die Datei erstellt wurde. |
SetCreationTimeUtc(SafeFileHandle, DateTime) |
Legt das Datum und die Uhrzeit in koordinierter Weltzeit (UTC) fest, das die Datei oder das Verzeichnis erstellt wurde. |
SetCreationTimeUtc(String, DateTime)
- Quelle:
- File.cs
- Quelle:
- File.cs
- Quelle:
- File.cs
Legt das Datum und die Uhrzeit in koordinierter Weltzeit (UTC) fest, das die Datei erstellt wurde.
public:
static void SetCreationTimeUtc(System::String ^ path, DateTime creationTimeUtc);
public static void SetCreationTimeUtc (string path, DateTime creationTimeUtc);
static member SetCreationTimeUtc : string * DateTime -> unit
Public Shared Sub SetCreationTimeUtc (path As String, creationTimeUtc As DateTime)
Parameter
- path
- String
Die Datei, für die die Erstellungsdatums- und Uhrzeitinformationen festgelegt werden sollen.
- creationTimeUtc
- DateTime
Der Wert, der für das Erstellungsdatum und die Uhrzeit von path
festgelegt werden soll. Dieser Wert wird in UTC-Zeit ausgedrückt.
Ausnahmen
Der angegebene Pfad wurde nicht gefunden.
.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path
ist 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.
path
ist null
.
Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.
Beim Ausführen des Vorgangs ist ein E/A-Fehler aufgetreten.
creationTimeUtc
gibt einen Wert außerhalb des Bereichs von Datumsangaben, Uhrzeiten oder beides an, die für diesen Vorgang zulässig sind.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
path
weist ein ungültiges Format auf.
Hinweise
Der path
-Parameter darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert. Informationen zum Abrufen des aktuellen Arbeitsverzeichnisses finden Sie unter GetCurrentDirectory.
NTFS-formatierte Laufwerke können Dateimetainformationen, z. B. die Dateierstellungszeit, 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: Write Text to a File
Gilt für:
SetCreationTimeUtc(SafeFileHandle, DateTime)
- Quelle:
- File.cs
- Quelle:
- File.cs
- Quelle:
- File.cs
Legt das Datum und die Uhrzeit in koordinierter Weltzeit (UTC) fest, das die Datei oder das Verzeichnis erstellt wurde.
public:
static void SetCreationTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime creationTimeUtc);
public static void SetCreationTimeUtc (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime creationTimeUtc);
static member SetCreationTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit
Public Shared Sub SetCreationTimeUtc (fileHandle As SafeFileHandle, creationTimeUtc As DateTime)
Parameter
- fileHandle
- SafeFileHandle
Eine SafeFileHandle in die Datei oder das Verzeichnis, für die die Erstellungsdatums- und Uhrzeitinformationen festgelegt werden sollen.
- creationTimeUtc
- DateTime
Der Wert, der für das Erstellungsdatum und die Uhrzeit von fileHandle
festgelegt werden soll. Dieser Wert wird in UTC-Zeit ausgedrückt.
Ausnahmen
fileHandle
ist null
.
creationTimeUtc
gibt einen Wert außerhalb des Bereichs von Datumsangaben, Uhrzeiten oder beides an, die für diesen Vorgang zulässig sind.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Beim Ausführen des Vorgangs ist ein E/A-Fehler aufgetreten.