File.SetLastWriteTime Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Ü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

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

ArgumentNullException

fileHandle ist null

ArgumentOutOfRangeException

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

SetLastWriteTime(String, DateTime)

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

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 ein oder mehrere ungültige 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.

FileNotFoundException

Der angegebene Pfad wurde nicht gefunden.

UnauthorizedAccessException

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

NotSupportedException

path weist ein ungültiges Format auf.

ArgumentOutOfRangeException

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

• FileSystemWatcher
• Datei- und Stream-E/A
• Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei