File.GetCreationTime(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 de criação do arquivo ou diretório especificado.
public:
static DateTime GetCreationTime(System::String ^ path);
public static DateTime GetCreationTime (string path);
static member GetCreationTime : string -> DateTime
Public Shared Function GetCreationTime (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 criação.
Retornos
Uma estrutura DateTime definida como a data e a hora de criação para o arquivo ou diretório especificado. Esse valor é expresso no horário local.
Exceções
O chamador não tem a permissão necessária.
.NET Framework e versões do .NET Core anteriores à 2.1: é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém um ou mais path
caracteres inválidos. Consulte caracteres inválidos usando o método GetInvalidPathChars().
path
é null
.
O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.
path
está em um formato inválido.
Exemplos
O exemplo a seguir demonstra GetCreationTime
.
Imports System.IO
Module Module1
Sub Main()
Dim fileCreatedDate As DateTime = File.GetCreationTime("C:\Example\MyTest.txt")
Console.WriteLine("file created: " + fileCreatedDate)
End Sub
End Module
Comentários
Observação
Esse método pode retornar um valor impreciso, pois ele usa funções nativas cujos valores podem não ser atualizados continuamente pelo sistema operacional.
O path
parâmetro tem permissão para especificar informações de caminho relativo ou absoluto. 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 .
Se o arquivo descrito no parâmetro não existir, esse método retornará path
12:00 meia-noite de 1º de janeiro de 1601 D.C. (C.E.) Tempo Universal Coordenado (UTC), ajustado para a hora local.
Unidades formatadas em NTFS podem armazenar em cache informações sobre um arquivo, como o tempo de criação de arquivo, por um curto período de tempo. Como resultado, pode ser necessário definir explicitamente o tempo de criação de um arquivo se você estiver substituindo ou substituindo um arquivo existente.
Para ver uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.