File.SetCreationTimeUtc Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Überlädt

SetCreationTimeUtc(SafeFileHandle, DateTime)	Legt das Datum und die Uhrzeit der Erstellung der Datei oder des Verzeichnisses in koordinierter Weltzeit (UTC) fest.
SetCreationTimeUtc(String, DateTime)	Legt in koordinierter Weltzeit (UTC) das Datum und die Uhrzeit fest, an dem die Datei erstellt wurde.

SetCreationTimeUtc(SafeFileHandle, DateTime)

Quelle:

File.cs

Legt das Datum und die Uhrzeit der Erstellung der Datei oder des Verzeichnisses in koordinierter Weltzeit (UTC) fest.

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

Ein SafeFileHandle für die Datei oder das Verzeichnis, für das die Erstellungsdatums- und Uhrzeitinformationen festgelegt werden sollen.

creationTimeUtc

DateTime

Eine DateTime, die den festzulegenden Wert für Erstellungsdatum und -zeitpunkt von fileHandle enthält. Der Wert wird in UTC-Zeit angegeben.

Ausnahmen

ArgumentNullException

fileHandle ist null

ArgumentOutOfRangeException

creationTimeUtc gibt einen Wert außerhalb des Datums- und/oder Zeitbereichs an, der für diesen Vorgang zulässig ist.

UnauthorizedAccessException

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

IOException

Beim Ausführen des Vorgangs ist ein E/A-Fehler aufgetreten.

SetCreationTimeUtc(String, DateTime)

Quelle:

File.cs

Legt in koordinierter Weltzeit (UTC) das Datum und die Uhrzeit fest, an dem 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 Informationen über Erstellungsdatum und -zeitpunkt festgelegt werden sollen.

creationTimeUtc

DateTime

Eine DateTime, die den festzulegenden Wert für Erstellungsdatum und -zeitpunkt von path enthält. Der Wert wird in UTC-Zeit angegeben.

Ausnahmen

FileNotFoundException

Der angegebene Pfad wurde nicht gefunden.

ArgumentException

.NET Framework- und .NET Core-Versionen älter als 2.1: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder enthält mindestens ein 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.

IOException

Beim Ausführen des Vorgangs ist ein E/A-Fehler aufgetreten.

ArgumentOutOfRangeException

creationTime gibt einen Wert außerhalb des Datums- und/oder Zeitbereichs an, der für diesen Vorgang zulässig ist.

UnauthorizedAccessException

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

NotSupportedException

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: Schreiben von Text in eine Datei