File.SetLastWriteTime Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Sobrecargas

SetLastWriteTime(SafeFileHandle, DateTime)	Establece la fecha y hora en que se escribió por última vez el archivo o directorio especificados.
SetLastWriteTime(String, DateTime)	Establece la fecha y la hora en que escribió por última vez en el archivo especificado.

SetLastWriteTime(SafeFileHandle, DateTime)

Source:

File.cs

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

public:
 static void SetLastWriteTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime lastWriteTime);

public static void SetLastWriteTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime lastWriteTime);

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

Public Shared Sub SetLastWriteTime (fileHandle As SafeFileHandle, lastWriteTime As DateTime)

Parámetros

fileHandle

SafeFileHandle

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

lastWriteTime

DateTime

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

Excepciones

ArgumentNullException

fileHandle es null.

ArgumentOutOfRangeException

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

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

IOException

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

SetLastWriteTime(String, DateTime)

Source:

File.cs

Establece la fecha y la hora en que escribió por última vez en el archivo especificado.

public:
 static void SetLastWriteTime(System::String ^ path, DateTime lastWriteTime);

public static void SetLastWriteTime (string path, DateTime lastWriteTime);

static member SetLastWriteTime : string * DateTime -> unit

Public Shared Sub SetLastWriteTime (path As String, lastWriteTime As DateTime)

Parámetros

path

String

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

lastWriteTime

DateTime

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

Excepciones

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a 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 los caracteres no válidos con el método GetInvalidPathChars().

ArgumentNullException

path es null.

PathTooLongException

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

FileNotFoundException

No se encontró la ruta de acceso especificada.

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

NotSupportedException

path está en un formato no válido.

ArgumentOutOfRangeException

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

Ejemplos

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

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

try
    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 dt = File.GetLastWriteTime path
    printfn $"The last write 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)
            Else
                ' Take an 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

El path parámetro 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 tareas de E/S comunes, consulte Tareas de E/S comunes.

Consulte también

• FileSystemWatcher
• E/S de archivos y secuencias
• Leer texto de un archivo
• Cómo: Escribir texto en un archivo