FileSystemInfo.CreationTimeUtc Propriedade

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

FileSystemInfo.cs

Obtém ou define a hora de criação, em UTC (tempo universal coordenado), do arquivo ou diretório atual.

public:
 property DateTime CreationTimeUtc { DateTime get(); void set(DateTime value); };

public DateTime CreationTimeUtc { get; set; }

member this.CreationTimeUtc : DateTime with get, set

Public Property CreationTimeUtc As DateTime

Valor da propriedade

DateTime

A data e hora de criação no formato UTC do objeto FileSystemInfo atual.

Exceções

IOException

Refresh() não pode inicializar os dados.

DirectoryNotFoundException

O caminho especificado é inválido, por exemplo, ele está em uma unidade não mapeada.

PlatformNotSupportedException

O sistema operacional atual não é o Windows NT ou posterior.

ArgumentOutOfRangeException

O chamador tenta definir um tempo de criação inválido.

Comentários

Observação

Esse método pode retornar um valor impreciso porque usa funções nativas cujos valores podem não ser atualizados continuamente pelo sistema operacional.

O valor da CreationTimeUtc propriedade será pré-armazenado em cache se a instância atual do FileSystemInfo objeto tiver sido retornada de qualquer um dos seguintes DirectoryInfo métodos:

• DirectoryInfo.GetDirectories

• DirectoryInfo.GetFiles

• DirectoryInfo.GetFileSystemInfos

• DirectoryInfo.EnumerateDirectories

• DirectoryInfo.EnumerateFiles

• DirectoryInfo.EnumerateFileSystemInfos

Para obter o valor mais recente, chame o Refresh método .

Se o arquivo descrito no FileSystemInfo objeto não existir, essa propriedade retornará 12:00 meia-noite, 1º de janeiro de 1601 (C.E.) UTC (Tempo Universal Coordenado).

Em plataformas Unix que não dão suporte à criação ou à hora de nascimento, essa propriedade retorna o mais antigo da hora do último status alteração e a hora da última modificação. Em outras plataformas, ele retorna 12:00 meia-noite, 1º de janeiro de 1601 D.C. (C.E.) UTC (Tempo Universal Coordenado), ajustado para a hora local.

As unidades formatadas em NTFS podem armazenar em cache as meta-informações do arquivo, como o tempo de criação do arquivo, por um curto período de tempo. Esse processo é conhecido como túnel de arquivo. Como resultado, talvez seja necessário definir explicitamente o tempo de criação de um arquivo se você estiver substituindo ou substituindo um arquivo existente.

Confira também

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