File.GetLastAccessTimeUtc Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

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)	Retorna a data e a hora do último acesso, em UTC (Tempo Universal Coordenado), do arquivo ou diretório especificado.

GetLastAccessTimeUtc(String)

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 obter informações de data e hora de acesso.

Retornos

DateTime

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

Exceções

UnauthorizedAccessException

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

ArgumentException

Versões do .NET Framework e 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. Você pode consultar caracteres inválidos usando o método GetInvalidPathChars().

ArgumentNullException

path é null.

PathTooLongException

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

NotSupportedException

path está em um formato inválido.

Comentários

Nota

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 parâmetro path 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 parâmetro path tem permissão para especificar informações de caminho relativas ou absolutas. As informações de 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
• de E/S de Fluxo e Arquivo
• leitura de texto de uma de arquivo
• Como gravar texto em um arquivo

GetLastAccessTimeUtc(SafeFileHandle)

Origem:

File.cs

Retorna a data e a 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 estrutura DateTime definida como a última data e hora de acesso para o arquivo ou diretório especificado. Esse valor é expresso em tempo UTC.

Exceções

ArgumentNullException

fileHandle é null.

UnauthorizedAccessException

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