FileSystemInfo.CreationTime Propriedade

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

Obtém ou define a hora de criação do ficheiro ou diretório atual.

public:
 property DateTime CreationTime { DateTime get(); void set(DateTime value); };
public DateTime CreationTime { get; set; }
member this.CreationTime : DateTime with get, set
Public Property CreationTime As DateTime

Valor de Propriedade

DateTime

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

Exceções

IOException

Refresh() não é possível inicializar os dados.

DirectoryNotFoundException

O caminho especificado é inválido; por exemplo, está num disco não mapeado.

PlatformNotSupportedException

O sistema operativo atual não é Windows NT nem versões posteriores.

ArgumentOutOfRangeException

O chamador tenta definir uma hora de criação inválida.

Exemplos

O exemplo seguinte demonstra a CreationTime propriedade. Este exemplo de código faz parte de um exemplo maior fornecido para a FileSystemInfo classe.

static void DisplayFileSystemInfoAttributes(FileSystemInfo fsi)
{
    //  Assume that this entry is a file.
    string entryType = "File";

    // Determine if entry is really a directory
    if ((fsi.Attributes & FileAttributes.Directory) == FileAttributes.Directory )
    {
        entryType = "Directory";
    }
    //  Show this entry's type, name, and creation date.
    Console.WriteLine("{0} entry {1} was created on {2:D}", entryType, fsi.FullName, fsi.CreationTime);
}

Sub DisplayFileSystemInfoAttributes(ByVal fsi As IO.FileSystemInfo)
    ' Assume that this entry is a file.
    Dim entryType As String = "File"

    ' Determine if this entry is really a directory.
    If (fsi.Attributes And FileAttributes.Directory) = FileAttributes.Directory Then
        entryType = "Directory"
    End If

    ' Show this entry's type, name, and creation date.
    Console.WriteLine("{0} entry {1} was created on {2:D}", _
        entryType, fsi.FullName, fsi.CreationTime)
End Sub

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.

O valor da CreationTime propriedade é pré-cacheado se a instância atual do FileSystemInfo objeto foi devolvida de qualquer um dos seguintes DirectoryInfo métodos:

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

Se o ficheiro descrito no FileSystemInfo objeto não existir, esta propriedade retorna a meia-noite de 12:00 de 1 de janeiro de 1601 d.C. (d.C.) Tempo Universal Coordenado (UTC), ajustado à hora local.

Em plataformas Unix que não suportam a data de criação ou nascimento, esta propriedade devolve o mais antigo do momento da última alteração de estado e do momento da última modificação. Noutras plataformas, regressa às 12:00 da meia-noite, 1 de janeiro de 1601 d.C. (d.C.) Tempo Universal Coordenado (UTC), ajustado à hora local.

Discos formatados em NTFS podem armazenar em cache meta-informação de ficheiros, como o tempo de criação do ficheiro, por um curto período de tempo. Este processo é conhecido como tunelamento de ficheiros. 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.

Aplica-se a

Ver também