File.GetLastWriteTime(String) File.GetLastWriteTime(String) File.GetLastWriteTime(String) File.GetLastWriteTime(String) Method

Definición

Devuelve la fecha y hora a la que se escribió por última vez en el archivo o directorio especificado.Returns the date and time the specified file or directory was last written to.

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

Parámetros

path
String String String String

Archivo o directorio para el que se va a obtener información de fecha y hora de escritura.The file or directory for which to obtain write date and time information.

Devoluciones

Estructura DateTime que se establece en la fecha y hora a la que se escribió por última vez en el archivo o directorio especificado.A DateTime structure set to the date and time that the specified file or directory was last written to. Este valor se expresa en hora local.This value is expressed in local time.

Excepciones

El llamador no dispone del permiso requerido.The caller does not have the required permission.

path es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

path está en un formato no válido.path is in an invalid format.

Ejemplos

En el siguiente ejemplo GetLastWriteTimese muestra.The following example demonstrates 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());
        }
    }
}
Imports System
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

Comentarios

Nota

Este método puede devolver un valor inexacto, porque usa funciones nativas cuyos valores no se pueden actualizar continuamente mediante el sistema operativo.This method may return an inaccurate value, because it uses native functions whose values may not be continuously updated by the operating system. Cada sistema operativo administra la hora de la última escritura de acuerdo con sus propias reglas.Each operating system manages the last write time according to its own rules. Para mejorar el rendimiento, es posible que un sistema operativo no establezca el valor de hora de la última escritura en la hora exacta de la última operación de escritura, pero puede establecerlo en una aproximación aproximada.To improve performance, an operating system might not set the last write time value to the exact time of the last write operation, but might set it to a close approximation instead.

Si el archivo descrito en el path parámetro no existe, este método devuelve 12:00 de la medianoche del 1 de enero de 1601 d.c.If the file described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Hora universal coordinada (UTC), ajustado a la hora local.(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

El path parámetro puede especificar información de ruta de acceso relativa o absoluta.The path parameter is permitted to specify relative or absolute path information. La información de la ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual.Relative path information is interpreted as relative to the current working directory. Para obtener el directorio de trabajo actual, GetCurrentDirectoryvea.To obtain the current working directory, see GetCurrentDirectory.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Seguridad

FileIOPermission
para leer desde el archivo especificado.for reading from the specified file. Enumeración asociada:ReadAssociated enumeration: Read

Se aplica a

Consulte también: