File.GetLastAccessTime Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Überlädt

GetLastAccessTime(SafeFileHandle)	Gibt das Datum und die Uhrzeit des letzten Zugriffs der angegebenen Datei oder des angegebenen Verzeichnisses zurück.
GetLastAccessTime(String)	Gibt das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei bzw. das angegebene Verzeichnis zurück.

GetLastAccessTime(SafeFileHandle)

Quelle:

File.cs

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

public:
 static DateTime GetLastAccessTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static DateTime GetLastAccessTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetLastAccessTime : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime

Public Shared Function GetLastAccessTime (fileHandle As SafeFileHandle) As DateTime

Parameter

fileHandle

SafeFileHandle

Eine SafeFileHandle für die Datei oder das Verzeichnis, für die Datums- und Uhrzeitinformationen für den letzten Zugriff abgerufen werden sollen.

Gibt zurück

DateTime

Eine DateTime Struktur, die auf das Datum und die Uhrzeit des letzten Zugriffs für die angegebene Datei oder das angegebene Verzeichnis festgelegt ist. Dieser Wert wird in Ortszeit angegeben.

Ausnahmen

ArgumentNullException

fileHandle ist null.

UnauthorizedAccessException

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

GetLastAccessTime(String)

Quelle:

File.cs

Gibt das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei bzw. das angegebene Verzeichnis zurück.

public:
 static DateTime GetLastAccessTime(System::String ^ path);

public static DateTime GetLastAccessTime (string path);

static member GetLastAccessTime : string -> DateTime

Public Shared Function GetLastAccessTime (path As String) As DateTime

Parameter

path

String

Die Datei oder das Verzeichnis, für die bzw. das die Informationen über Zugriffsdatum und -zeitpunkt abgerufen werden sollen.

Gibt zurück

DateTime

Eine DateTime-Struktur, die auf das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei bzw. das angegebene Verzeichnis festgelegt wird. Dieser Wert wird in Ortszeit angegeben.

Ausnahmen

UnauthorizedAccessException

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

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

NotSupportedException

path weist ein ungültiges Format auf.

Beispiele

Das folgende Beispiel zeigt GetLastAccessTime.

using namespace System;
using namespace System::IO;
int main()
{
   try
   {
      String^ path = "c:\\Temp\\MyTest.txt";
      if (  !File::Exists( path ) )
      {
         File::Create( path );
      }
      File::SetLastAccessTime( path, DateTime(1985,5,4) );
      
      // Get the creation time of a well-known directory.
      DateTime dt = File::GetLastAccessTime( path );
      Console::WriteLine( "The last access time for this file was {0}.", dt );
      
      // Update the last access time.
      File::SetLastAccessTime( path, DateTime::Now );
      dt = File::GetLastAccessTime( path );
      Console::WriteLine( "The last access 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);
            }
            File.SetLastAccessTime(path, new DateTime(1985,5,4));

            // Get the creation time of a well-known directory.
            DateTime dt = File.GetLastAccessTime(path);
            Console.WriteLine("The last access time for this file was {0}.", dt);
            
            // Update the last access time.
            File.SetLastAccessTime(path, DateTime.Now);
            dt = File.GetLastAccessTime(path);
            Console.WriteLine("The last access 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

File.SetLastAccessTime(path, DateTime(1985, 5, 4))

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

// Update the last access time.
File.SetLastAccessTime(path, DateTime.Now)
let dt2 = File.GetLastAccessTime path
printfn $"The last access 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)
            End If
            File.SetLastAccessTime(path, New DateTime(1985, 5, 4))

            ' Get the creation time of a well-known directory.
            Dim dt As DateTime = File.GetLastAccessTime(path)

            Console.WriteLine("The last access time for this file was {0}.", dt)

            ' Update the last access time.
            File.SetLastAccessTime(path, DateTime.Now)
            dt = File.GetLastAccessTime(path)
            Console.WriteLine("The last access 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

Hinweis

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.

Wenn die im path Parameter beschriebene Datei nicht vorhanden ist, gibt diese Methode am 1. Januar 1601 n. Januar 12:00 Uhr 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

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