File.GetLastWriteTimeUtc(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve a data e hora, em Tempo Universal Coordenado (UTC), em que o ficheiro ou diretório especificado foi escrito 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 ficheiro ou diretório para o qual obter a data e hora de escrita.
Devoluções
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 UTC.
Exceções
O interlocutor não tem a permissão necessária.
.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.
path é null.
O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.
path está num formato inválido.
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).
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.