File.GetLastAccessTimeUtc Método

  • Referência

Definição

Namespace:
System.IO
Assembly:
System.Runtime.dll
Assemblies:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Sobrecargas

GetLastAccessTimeUtc(SafeFileHandle)

Retorna a data e hora do último acesso, em UTC (Tempo Universal Coordenado), do arquivo ou diretório especificado.
GetLastAccessTimeUtc(String)

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

GetLastAccessTimeUtc(SafeFileHandle)

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

Retorna a data e hora do último acesso, em UTC (Tempo Universal Coordenado), do arquivo ou diretório especificado.

public:
 static DateTime GetLastAccessTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);
public static DateTime GetLastAccessTimeUtc (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);
static member GetLastAccessTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime
Public Shared Function GetLastAccessTimeUtc (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 do último acesso.

Retornos

DateTime

Uma DateTime estrutura definida como a data e hora do último acesso 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.

Aplica-se a

GetLastAccessTimeUtc(String)

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

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

public:
 static DateTime GetLastAccessTimeUtc(System::String ^ path);
public static DateTime GetLastAccessTimeUtc (string path);
static member GetLastAccessTimeUtc : string -> DateTime
Public Shared Function GetLastAccessTimeUtc (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 acesso serão obtidas.

Retornos

DateTime

Uma estrutura de DateTime definida como a data e hora em que o arquivo ou diretório especificado foi acessado 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.

Se o arquivo descrito no path parâmetro não existir, esse método retornará 12:00 meia-noite, 1º de janeiro de 1601 D.C. (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

Aplica-se a