File.GetLastWriteTimeUtc Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

GetLastWriteTimeUtc(SafeFileHandle)	Retorna a data e a hora da última gravação, em UTC (Tempo Universal Coordenado), do arquivo ou diretório especificado.
GetLastWriteTimeUtc(String)	Retorna a data e a hora, em UTC (Tempo Universal Coordenado), em que o arquivo ou diretório especificado foi gravado pela última vez.

GetLastWriteTimeUtc(SafeFileHandle)

Origem:

File.cs

Retorna a data e a hora da última gravação, em UTC (Tempo Universal Coordenado), do arquivo ou diretório especificado.

public:
 static DateTime GetLastWriteTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static DateTime GetLastWriteTimeUtc (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetLastWriteTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime

Public Shared Function GetLastWriteTimeUtc (fileHandle As SafeFileHandle) As DateTime

Parâmetros

fileHandle

SafeFileHandle

Um SafeFileHandle para o arquivo ou diretório para o qual obter informações de data e hora da última gravação.

Retornos

DateTime

Uma DateTime estrutura definida como a última data e hora de gravação para o arquivo ou diretório especificado. Esse valor é expresso em horário UTC.

Exceções

ArgumentNullException

fileHandle é null.

UnauthorizedAccessException

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

GetLastWriteTimeUtc(String)

Origem:

File.cs

Retorna a data e a hora, em UTC (Tempo Universal Coordenado), em que o arquivo ou diretório especificado foi gravado pela última vez.

public:
 static DateTime GetLastWriteTimeUtc(System::String ^ path);

public static DateTime GetLastWriteTimeUtc (string path);

static member GetLastWriteTimeUtc : string -> DateTime

Public Shared Function GetLastWriteTimeUtc (path As String) As DateTime

Parâmetros

path

String

O arquivo ou diretório para o qual as informações de data e hora de gravação serão obtidas.

Retornos

DateTime

Uma estrutura DateTime definida com a data e hora em que o arquivo ou diretório especificado foi gravado pela última vez. Esse valor é expresso em horário UTC.

Exceções

UnauthorizedAccessException

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

ArgumentException

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

ArgumentNullException

path é null.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

NotSupportedException

path está em um formato inválido.

Comentários

Observação

Esse método pode retornar um valor impreciso, pois usa funções nativas cujos valores podem não ser atualizados continuamente pelo sistema operacional. Cada sistema operacional gerencia o último tempo de gravação de acordo com suas próprias regras. Para melhorar o desempenho, um sistema operacional pode não definir o último valor de tempo de gravação para a hora exata da última operação de gravação, mas pode defini-lo como uma aproximação próxima.

Se o arquivo descrito no path parâmetro não existir, esse método retornará 12:00 meia-noite, 1º de janeiro de 1601 (C.E.) UTC (Tempo Universal Coordenado).

O path parâmetro tem permissão para especificar informações de caminho relativas ou absolutas. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory.

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

Confira também

• FileSystemWatcher
• E/S de arquivo e de fluxo
• Lendo texto de um arquivo
• Como gravar texto em um arquivo