File.GetLastWriteTime Método

Definição

Espaço de Nomes:
System.IO
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagens:
mscorlib.dll, System.IO.FileSystem.dll
Assemblagens:
netstandard.dll, System.IO.FileSystem.dll
Assemblagens:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Assemblagem:
System.IO.FileSystem.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Sobrecargas

Name Description
GetLastWriteTime(SafeFileHandle)

Devolve a última data e hora de escrita do ficheiro ou diretório especificado.
GetLastWriteTime(String)

Devolve a data e hora em que o ficheiro ou diretório especificado foi escrito pela última vez.

GetLastWriteTime(SafeFileHandle)

Origem:
File.cs
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs

Devolve a última data e hora de escrita do ficheiro ou diretório especificado.

public:
 static DateTime GetLastWriteTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);
public static DateTime GetLastWriteTime(Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);
static member GetLastWriteTime : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime
Public Shared Function GetLastWriteTime (fileHandle As SafeFileHandle) As DateTime

Parâmetros

fileHandle
SafeFileHandle

A SafeFileHandle ao ficheiro ou diretório para o qual obter a data e hora da última escrita.

Devoluções

DateTime

Uma DateTime estrutura definida para a última data e hora de escrita do ficheiro ou diretório especificados. Este valor é expresso em tempo local.

Exceções

ArgumentNullException

fileHandle é null.

UnauthorizedAccessException

O interlocutor não tem a permissão necessária.

Aplica-se a

GetLastWriteTime(String)

Origem:
File.cs
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs
Origem:
File.cs

Devolve a data e hora em que o ficheiro ou diretório especificado foi escrito pela última vez.

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

O ficheiro ou diretório para o qual obter a data e hora de escrita.

Devoluções

DateTime

Uma estrutura definida DateTime para a data e hora em que o ficheiro ou diretório especificado foi escrito pela última vez. Este valor é expresso em tempo local.

Exceções

UnauthorizedAccessException

O interlocutor não tem a permissão necessária.

ArgumentException

.NET Framework e .NET Core versões anteriores à 2.1: path é uma cadeia de comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos. Pode consultar caracteres inválidos usando o GetInvalidPathChars() método.

ArgumentNullException

path é null.

PathTooLongException

O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.

NotSupportedException

path está num formato inválido.

Exemplos

O exemplo abaixo demonstra GetLastWriteTime.

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

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 dt2 = File.GetLastWriteTime path
printfn $"The last write 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)
            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

Observações

Note

Este método pode devolver um valor impreciso, porque utiliza funções nativas cujos valores podem não ser continuamente atualizados pelo sistema operativo. Cada sistema operativo gere o último tempo de escrita de acordo com as suas próprias regras. Para melhorar o desempenho, um sistema operativo pode não definir o valor do último tempo de escrita para o momento exato da última operação de escrita, mas sim defini-lo para uma aproximação próxima.

Se o ficheiro descrito no path parâmetro não existir, este método retorna meia-noite 12:00 de 1 de janeiro de 1601 d.C. (d.C.) Tempo Universal Coordenado (UTC), ajustado à hora local.

O path parâmetro pode especificar informação relativa ou absoluta do caminho. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual. Para obter o diretório de trabalho atual, veja GetCurrentDirectory.

Para uma lista de tarefas comuns de E/S, consulte Tarefas Comuns de E/S.

Ver também

Aplica-se a