File.SetLastAccessTime Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Überlädt

SetLastAccessTime(String, DateTime)	Legt das Datum und die Uhrzeit fest, zu der die angegebene Datei zuletzt zugegriffen wurde.
SetLastAccessTime(SafeFileHandle, DateTime)	Legt das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei oder das angegebene Verzeichnis fest.

SetLastAccessTime(String, DateTime)

Quelle:

File.cs

Legt das Datum und die Uhrzeit fest, zu der die angegebene Datei zuletzt zugegriffen wurde.

public:
 static void SetLastAccessTime(System::String ^ path, DateTime lastAccessTime);

public static void SetLastAccessTime (string path, DateTime lastAccessTime);

static member SetLastAccessTime : string * DateTime -> unit

Public Shared Sub SetLastAccessTime (path As String, lastAccessTime As DateTime)

Parameter

path

String

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

lastAccessTime

DateTime

Eine DateTime, die den Wert enthält, der für das datum und die Uhrzeit des letzten Zugriffs von pathfestgelegt werden soll. Dieser Wert wird in der Ortszeit ausgedrückt.

Ausnahmen

ArgumentException

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

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 weist ein ungültiges Format auf.

ArgumentOutOfRangeException

lastAccessTime 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, ggf. erstellt, und anschließend wird die letzte Zugriffszeit 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 );
         
         // Update the last access time.    
      }
      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);
                // Update the last access time.	
            }
            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

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

    if File.Exists path |> not then
        File.Create path |> ignore

    // Update the last access time.
    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 dt = File.GetLastAccessTime path
    printfn $"The last access 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)
            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

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: Write Text to a File

SetLastAccessTime(SafeFileHandle, DateTime)

Quelle:

File.cs

Legt das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei oder das angegebene Verzeichnis fest.

public:
 static void SetLastAccessTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime lastAccessTime);

public static void SetLastAccessTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime lastAccessTime);

static member SetLastAccessTime : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit

Public Shared Sub SetLastAccessTime (fileHandle As SafeFileHandle, lastAccessTime As DateTime)

Parameter

fileHandle

SafeFileHandle

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

lastAccessTime

DateTime

Eine DateTime, die den Wert enthält, der für das datum und die Uhrzeit des letzten Zugriffs von fileHandlefestgelegt werden soll. Dieser Wert wird in der Ortszeit ausgedrückt.

Ausnahmen

ArgumentNullException

fileHandle ist null.

ArgumentOutOfRangeException

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