Leer en inglés

Compartir a través de


File.SetLastAccessTime Método

Definición

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

SetLastAccessTime(String, DateTime)

Establece la fecha y hora en que se accedió por última vez al archivo especificado.

SetLastAccessTime(SafeFileHandle, DateTime)

Establece la fecha y hora en que se accedió por última vez al archivo o directorio especificados.

SetLastAccessTime(String, DateTime)

Source:
File.cs
Source:
File.cs
Source:
File.cs

Establece la fecha y hora en que se accedió por última vez al archivo especificado.

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

Parámetros

path
String

Archivo para el que se va a establecer la información de fecha y hora de acceso.

lastAccessTime
DateTime

Un DateTime que contiene el valor que se va a establecer para la última fecha y hora de acceso de path. Este valor se expresa en la hora local.

Excepciones

Versiones de .NET Framework y .NET Core anteriores a la 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene uno o varios caracteres no válidos. Puede consultar caracteres no válidos mediante el método GetInvalidPathChars().

path es null.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

No se encontró la ruta de acceso especificada.

El autor de la llamada no tiene el permiso necesario.

path tiene un formato no válido.

lastAccessTime especifica un valor fuera del intervalo de fechas o horas permitidas para esta operación.

Ejemplos

En el ejemplo siguiente se comprueba el sistema de archivos para el archivo especificado, se crea si es necesario y, a continuación, se establece y obtiene la hora de último acceso.

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());
        }
    }
}

Comentarios

El parámetro path puede especificar información de ruta de acceso relativa o absoluta. La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual. Para obtener el directorio de trabajo actual, consulte GetCurrentDirectory.

Para obtener una lista de las tareas comunes de E/S, consulte Tareas de E/S comunes.

Consulte también

Se aplica a

.NET 10 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

SetLastAccessTime(SafeFileHandle, DateTime)

Source:
File.cs
Source:
File.cs
Source:
File.cs

Establece la fecha y hora en que se accedió por última vez al archivo o directorio especificados.

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

Parámetros

fileHandle
SafeFileHandle

Un SafeFileHandle al archivo o directorio para el que se va a establecer la última información de fecha y hora de acceso.

lastAccessTime
DateTime

Un DateTime que contiene el valor que se va a establecer para la última fecha y hora de acceso de fileHandle. Este valor se expresa en la hora local.

Excepciones

fileHandle es null.

lastAccessTime especifica un valor fuera del intervalo de fechas, horas o ambos permitidos para esta operación.

El autor de la llamada no tiene el permiso necesario.

Error de E/S al realizar la operación.

Se aplica a

.NET 10 y otras versiones
Producto Versiones
.NET 7, 8, 9, 10