Teilen über


File.GetLastWriteTime Methode

Definition

Überlädt

GetLastWriteTime(SafeFileHandle)

Gibt das Datum und die Uhrzeit des letzten Schreibvorgangs der angegebenen Datei oder des angegebenen Verzeichnisses zurück.

GetLastWriteTime(String)

Gibt das Datum und die Uhrzeit zurück, in das die angegebene Datei oder das angegebene Verzeichnis zuletzt geschrieben wurde.

GetLastWriteTime(SafeFileHandle)

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

Gibt das Datum und die Uhrzeit des letzten Schreibvorgangs der angegebenen Datei oder des angegebenen Verzeichnisses zurück.

public:
 static DateTime GetLastWriteTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);
public static DateTime GetLastWriteTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);
static member GetLastWriteTime : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime
Public Shared Function GetLastWriteTime (fileHandle As SafeFileHandle) As DateTime

Parameter

fileHandle
SafeFileHandle

Eine SafeFileHandle in die Datei oder das Verzeichnis, für die Datums- und Uhrzeitinformationen zum letzten Schreiben verwendet werden sollen.

Gibt zurück

Eine DateTime Struktur, die auf das datum und die Uhrzeit des letzten Schreibvorgangs für die angegebene Datei oder das angegebene Verzeichnis festgelegt ist. Dieser Wert wird in der Ortszeit ausgedrückt.

Ausnahmen

fileHandle ist null.

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

Gilt für:

GetLastWriteTime(String)

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

Gibt das Datum und die Uhrzeit zurück, in das die angegebene Datei oder das angegebene Verzeichnis zuletzt geschrieben wurde.

public:
 static DateTime GetLastWriteTime(System::String ^ path);
public static DateTime GetLastWriteTime (string path);
static member GetLastWriteTime : string -> DateTime
Public Shared Function GetLastWriteTime (path As String) As DateTime

Parameter

path
String

Die Datei oder das Verzeichnis, für die Schreib- und Uhrzeitinformationen abzurufen sind.

Gibt zurück

Eine DateTime Struktur, die auf das Datum und die Uhrzeit festgelegt ist, in das die angegebene Datei oder das angegebene Verzeichnis zuletzt geschrieben wurde. Dieser Wert wird in der Ortszeit ausgedrückt.

Ausnahmen

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

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

path ist null.

Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.

path weist ein ungültiges Format auf.

Beispiele

Das folgende Beispiel veranschaulicht GetLastWriteTime.

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

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 dt2 = File.GetLastWriteTime path
printfn $"The last write time for this file was {dt2}."
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 some 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

Anmerkung

Diese Methode gibt möglicherweise einen ungenauen Wert zurück, da sie systemeigene Funktionen verwendet, deren Werte möglicherweise nicht kontinuierlich vom Betriebssystem aktualisiert werden. Jedes Betriebssystem verwaltet die letzte Schreibzeit gemäß eigenen Regeln. Um die Leistung zu verbessern, legt ein Betriebssystem möglicherweise nicht den letzten Schreibzeitwert auf die genaue Uhrzeit des letzten Schreibvorgangs fest, legt ihn aber stattdessen auf eine enge Annäherung fest.

Wenn die im parameter path beschriebene Datei nicht vorhanden ist, gibt diese Methode 12:00 Mitternacht, den 1. Januar 1601 A.D. (C.E.) zurück. Koordinierte Weltzeit (UTC), angepasst an die Ortszeit.

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: