File.SetLastWriteTime Methode

Definition

Überlädt

SetLastWriteTime(SafeFileHandle, DateTime)

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

SetLastWriteTime(String, DateTime)

Legt das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei fest.

SetLastWriteTime(SafeFileHandle, DateTime)

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

Legt das Datum und die Uhrzeit fest, in die 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

Ein SafeFileHandle für die Datei oder das Verzeichnis, für die die Datums- und Uhrzeitinformationen des letzten Schreibvorgangs festgelegt werden sollen.

lastWriteTime
DateTime

Eine DateTime, die den festzulegenden Wert für Datum und Uhrzeit des letzten Schreibvorgangs von fileHandle enthält. Dieser Wert wird in Ortszeit angegeben.

Ausnahmen

fileHandle ist null

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

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

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

Legt das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei fest.

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 Informationen über Datum und Uhrzeit festgelegt werden sollen.

lastWriteTime
DateTime

Eine DateTime, die den festzulegenden Wert für Datum und Uhrzeit des letzten Schreibvorgangs von path enthält. Dieser Wert wird in Ortszeit angegeben.

Ausnahmen

.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 ein oder mehrere ungültige Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

path ist null.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

Der angegebene Pfad wurde nicht gefunden.

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

path weist ein ungültiges Format auf.

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

Beispiele

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

using namespace System;
using namespace System::IO;
int 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, 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 );
   }

}
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 der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für: