File.SetCreationTime Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Überlädt

SetCreationTime(SafeFileHandle, DateTime)	Legt das Datum und die Uhrzeit der Erstellung der Datei oder des Verzeichnisses fest.
SetCreationTime(String, DateTime)	Legt das Datum und die Uhrzeit fest, zu dem die Datei erstellt wurde.

SetCreationTime(SafeFileHandle, DateTime)

Quelle:

File.cs

Legt das Datum und die Uhrzeit der Erstellung der Datei oder des Verzeichnisses fest.

public:
 static void SetCreationTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime creationTime);

public static void SetCreationTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime creationTime);

static member SetCreationTime : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit

Public Shared Sub SetCreationTime (fileHandle As SafeFileHandle, creationTime As DateTime)

Parameter

fileHandle

SafeFileHandle

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

creationTime

DateTime

Eine DateTime, die den Wert enthält, der für das Erstellungsdatum und die Uhrzeit der fileHandlefestgelegt werden soll. Dieser Wert wird in der Ortszeit ausgedrückt.

Ausnahmen

ArgumentNullException

fileHandle ist null.

ArgumentOutOfRangeException

creationTime gibt einen Wert außerhalb des Bereichs von Datumsangaben, Uhrzeiten oder beides an, die für diesen Vorgang zulässig sind.

UnauthorizedAccessException

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

IOException

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

SetCreationTime(String, DateTime)

Quelle:

File.cs

Legt das Datum und die Uhrzeit fest, zu dem die Datei erstellt wurde.

public:
 static void SetCreationTime(System::String ^ path, DateTime creationTime);

public static void SetCreationTime (string path, DateTime creationTime);

static member SetCreationTime : string * DateTime -> unit

Public Shared Sub SetCreationTime (path As String, creationTime As DateTime)

Parameter

path

String

Die Datei, für die die Erstellungsdatums- und Uhrzeitinformationen festgelegt werden sollen.

creationTime

DateTime

Eine DateTime, die den Wert enthält, der für das Erstellungsdatum und die Uhrzeit der pathfestgelegt werden soll. Dieser Wert wird in der Ortszeit ausgedrückt.

Ausnahmen

FileNotFoundException

Der angegebene Pfad wurde nicht gefunden.

ArgumentException

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

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide ü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 Bereichs von Datumsangaben, Uhrzeiten oder beides an, die für diesen Vorgang zulässig sind.

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: Write Text to a File