File.GetLastWriteTimeUtc(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> DateTimePublic Shared Function GetLastWriteTimeUtc (path As String) As DateTimeParâmetros
- path
- String
O arquivo ou diretório para o qual obter informações de data e hora de gravação.
Retornos
Uma DateTime estrutura definida como a data e a hora em que o arquivo ou diretório especificado foi gravado pela última vez. Esse valor é expresso em tempo UTC.
Exceções
O chamador não tem a permissão necessária.
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 GetInvalidPathChars() método.
path é null.
O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.
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 D.C.) UTC (Tempo Universal Coordenado).
O path parâmetro 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.