File.GetCreationTimeUtc(String) Método

Definição

Espaço de Nomes:
System.IO
Assemblagens:
mscorlib.dll, System.IO.FileSystem.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.IO.FileSystem.dll
Assemblagem:
netstandard.dll

Devolve a data e hora de criação, em Tempo Universal Coordenado (UTC), do ficheiro ou diretório especificado.

public:
 static DateTime GetCreationTimeUtc(System::String ^ path);
public static DateTime GetCreationTimeUtc(string path);
static member GetCreationTimeUtc : string -> DateTime
Public Shared Function GetCreationTimeUtc (path As String) As DateTime

Parâmetros

path
String

O ficheiro ou diretório para o qual obter a data e hora da criação.

Devoluções

DateTime

Uma estrutura definida DateTime para a data e hora de criação do ficheiro ou diretório especificado. Este valor é expresso em tempo UTC.

Exceções

UnauthorizedAccessException

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

ArgumentException

.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.

ArgumentNullException

path é null.

PathTooLongException

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

NotSupportedException

path está num formato inválido.

Exemplos

O exemplo seguinte demonstra o GetCreationTimeUtc método.

Imports System.IO

Module Module1

    Sub Main()
        Dim fileCreatedDate As DateTime = File.GetCreationTimeUtc("C:\Example\MyTest.txt")
        Console.WriteLine("file created: " + fileCreatedDate)
    End Sub

End Module

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.

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).

Discos formatados em NTFS podem armazenar em cache informação sobre um ficheiro, como o tempo de criação do ficheiro, durante um curto período de tempo. Como resultado, pode ser necessário definir explicitamente o tempo de criação de um ficheiro se estiver a sobrescrever ou substituir um ficheiro existente.

Para uma lista de tarefas comuns de E/S, consulte Tarefas Comuns de E/S.

Aplica-se a

Ver também