FileSystemInfo.CreationTime Propriedade

  • Referência

Definição

Namespace:
System.IO
Assemblies:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
FileSystemInfo.cs
Origem:
FileSystemInfo.cs
Origem:
FileSystemInfo.cs

Obtém ou define a hora de criação do arquivo 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 da propriedade

DateTime

A data e hora de criação 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.

Exemplos

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

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

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 CreationTime 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:

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 D.C. (C.E.) UTC (Tempo Universal Coordenado), ajustado para a hora local.

Em plataformas Unix que não dão suporte à criação ou à hora de nascimento, essa propriedade retorna o mais antigo da hora da última 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, pode ser necessário definir explicitamente a hora de criação de um arquivo se você estiver substituindo ou substituindo um arquivo existente.

Aplica-se a

Confira também