File.GetCreationTimeUtc Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

GetCreationTimeUtc(SafeFileHandle)	Retorna a data e hora de criação, em UTC (Tempo Universal Coordenado), do arquivo ou diretório especificado.
GetCreationTimeUtc(String)	Retorna a data e hora de criação, em UTC (Tempo Universal Coordenado), do arquivo ou diretório especificado.

GetCreationTimeUtc(SafeFileHandle)

Origem:

File.cs

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

public:
 static DateTime GetCreationTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static DateTime GetCreationTimeUtc (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetCreationTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime

Public Shared Function GetCreationTimeUtc (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 de criação.

Retornos

DateTime

Uma estrutura DateTime definida como a data e a hora de criação para o arquivo ou diretório especificado. Esse valor é expresso em horário UTC.

Exceções

ArgumentNullException

fileHandle é null.

UnauthorizedAccessException

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

GetCreationTimeUtc(String)

Origem:

File.cs

Retorna a data e hora de criação, em UTC (Tempo Universal Coordenado), do arquivo 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 arquivo ou diretório para o qual obter informações de data e hora de criação.

Retornos

DateTime

Uma estrutura DateTime definida como a data e a hora de criação para o arquivo ou diretório especificado. Esse valor é expresso em horário UTC.

Exceções

UnauthorizedAccessException

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

ArgumentException

.NET Framework e versões 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. Consulte caracteres inválidos usando o método GetInvalidPathChars().

ArgumentNullException

path é null.

PathTooLongException

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

NotSupportedException

path está em um formato inválido.

Exemplos

O exemplo a seguir 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

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.

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. (C.E.) UTC (Tempo Universal Coordenado).

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 a hora de criação de um arquivo se você estiver substituindo ou substituindo um arquivo existente.

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

Confira também

• FileSystemWatcher
• E/S de arquivo e de fluxo
• Lendo texto de um arquivo
• Como gravar texto em um arquivo