File.SetLastWriteTime Methode

Definition

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

Überlädt

Name Beschreibung
SetLastWriteTime(SafeFileHandle, DateTime)

Legt das Datum und die Uhrzeit fest, in das die angegebene Datei oder das angegebene Verzeichnis zuletzt geschrieben wurde.
SetLastWriteTime(String, DateTime)

Legt das Datum und die Uhrzeit fest, in das die angegebene Datei zuletzt geschrieben wurde.

SetLastWriteTime(SafeFileHandle, DateTime)

Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Legt das Datum und die Uhrzeit fest, in das die angegebene Datei oder das angegebene Verzeichnis zuletzt geschrieben wurde.

public:
 static void SetLastWriteTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime lastWriteTime);
public static void SetLastWriteTime(Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime lastWriteTime);
static member SetLastWriteTime : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit
Public Shared Sub SetLastWriteTime (fileHandle As SafeFileHandle, lastWriteTime As DateTime)

Parameter

fileHandle
SafeFileHandle

A SafeFileHandle für die Datei oder das Verzeichnis, für die die Letzten Schreibdatums- und Uhrzeitinformationen festgelegt werden sollen.

lastWriteTime
DateTime

A DateTime containing the value to set for the last write date and time of fileHandle. Dieser Wert wird in der Ortszeit ausgedrückt.

Ausnahmen

ArgumentNullException

fileHandle ist null.

ArgumentOutOfRangeException

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

Gilt für:

SetLastWriteTime(String, DateTime)

Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Legt das Datum und die Uhrzeit fest, in das die angegebene Datei zuletzt geschrieben wurde.

public:
 static void SetLastWriteTime(System::String ^ path, DateTime lastWriteTime);
public static void SetLastWriteTime(string path, DateTime lastWriteTime);
static member SetLastWriteTime : string * DateTime -> unit
Public Shared Sub SetLastWriteTime (path As String, lastWriteTime As DateTime)

Parameter

path
String

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

lastWriteTime
DateTime

A DateTime containing the value to set for the last write date and time of path. Dieser Wert wird in der Ortszeit ausgedrückt.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path 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.

FileNotFoundException

Der angegebene Pfad wurde nicht gefunden.

UnauthorizedAccessException

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

NotSupportedException

path ist in einem ungültigen Format vorhanden.

ArgumentOutOfRangeException

lastWriteTime Gibt einen Wert außerhalb des Für diesen Vorgang zulässigen Datums- oder Uhrzeitbereichs an.

Beispiele

Im folgenden Beispiel wird das Dateisystem für die angegebene Datei überprüft, die Datei bei Bedarf erstellt, und anschließend wird die letzte Schreibzeit der Datei festgelegt und abgerufen.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            string path = @"c:\Temp\MyTest.txt";
            if (!File.Exists(path))
            {
                File.Create(path);
            }
            else
            {
                // Take an action that will affect the write time.
                File.SetLastWriteTime(path, new DateTime(1985,4,3));
            }

            // Get the creation time of a well-known directory.
            DateTime dt = File.GetLastWriteTime(path);
            Console.WriteLine("The last write time for this file was {0}.", dt);
            
            // Update the last write time.
            File.SetLastWriteTime(path, DateTime.Now);
            dt = File.GetLastWriteTime(path);
            Console.WriteLine("The last write time for this file was {0}.", dt);
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

open System
open System.IO

try
    let path = @"c:\Temp\MyTest.txt"

    if File.Exists path |> not then
        File.Create path |> ignore
    else
        // Take an action that will affect the write time.
        File.SetLastWriteTime(path, DateTime(1985, 4, 3))

    // Get the creation time of a well-known directory.
    let dt = File.GetLastWriteTime path
    printfn $"The last write time for this file was {dt}."

    // Update the last write time.
    File.SetLastWriteTime(path, DateTime.Now)
    let dt = File.GetLastWriteTime path
    printfn $"The last write time for this file was {dt}."
with
| e -> printfn $"The process failed: {e}"

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Try
            Dim path As String = "c:\Temp\MyTest.txt"

            If File.Exists(path) = False Then
                File.Create(path)
            Else
                ' Take an action that will affect the write time.
                File.SetLastWriteTime(path, New DateTime(1985, 4, 3))
            End If

            ' Get the creation time of a well-known directory.
            Dim dt As DateTime = File.GetLastWriteTime(path)
            Console.WriteLine("The last write time for this file was {0}.", dt)

            ' Update the last write time.
            File.SetLastWriteTime(path, DateTime.Now)
            dt = File.GetLastWriteTime(path)
            Console.WriteLine("The last write time for this file was {0}.", dt)

        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

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.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für: