File.SetCreationTimeUtc(String, DateTime) 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

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.

Legt das Datum und die Uhrzeit der Erstellung der Datei im UTC-Format (Coordinated Universal Time) fest.

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

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

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 fest zu legen, wenn Sie eine vorhandene Datei überschreiben oder ersetzen.

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

Gilt für: