FileSystemInfo.CreationTime FileSystemInfo.CreationTime FileSystemInfo.CreationTime FileSystemInfo.CreationTime Property

定義

取得或設定目前檔案或目錄的建立時間。Gets or sets the creation time of the current file or directory.

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

屬性值

目前的 FileSystemInfo 物件的建立日期和時間。The creation date and time of the current FileSystemInfo object.

例外狀況

Refresh() 無法初始化資料。Refresh() cannot initialize the data.

指定的路徑無效;例如,位於未對應的磁碟上。The specified path is invalid; for example, it is on an unmapped drive.

目前的作業系統不是 Windows NT 或更新版本。The current operating system is not Windows NT or later.

呼叫端嘗試設定無效的建立時間。The caller attempts to set an invalid creation time.

範例

下列範例會示範CreationTime屬性。The following example demonstrates the CreationTime property. 這個程式碼範例是針對FileSystemInfo類別提供之較大範例的一部分。This code example is part of a larger example provided for the FileSystemInfo class.

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

備註

注意

這個方法可能會傳回不正確的值, 因為它會使用原生函式, 其值可能不會由作業系統持續更新。This method may return an inaccurate value because it uses native functions whose values may not be continuously updated by the operating system.

如果FileSystemInfo物件的目前CreationTime實例是從下列DirectoryInfo任何一種方法傳回, 則會預先快取屬性的值:The value of the CreationTime property is pre-cached if the current instance of the FileSystemInfo object was returned from any of the following DirectoryInfo methods:

若要取得最新的值, Refresh請呼叫方法。To get the latest value, call the Refresh method.

如果FileSystemInfo物件中所描述的檔案不存在, 此屬性會傳回12:00 年1月 1601 1 日午夜If the file described in the FileSystemInfo object does not exist, this property returns 12:00 midnight, January 1, 1601 A.D. 西元國際標準時間 (UTC), 調整為當地時間。(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

在不支援建立或出生時間的 Unix 平臺上, 此屬性會傳回上次狀態變更時間和上次修改時間的較舊版本。On Unix platforms that do not support creation or birth time, this property returns the older of the time of the last status change and the time of the last modification. 在其他平臺上, 它會在西元1601年1月1日午夜傳回12:00On other platforms, it returns 12:00 midnight, January 1, 1601 A.D. 西元國際標準時間 (UTC), 調整為當地時間。(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

NTFS 格式的磁片磁碟機可能會在短時間內快取檔案中繼資訊, 例如檔案建立時間。NTFS-formatted drives may cache file meta-info, such as file creation time, for a short period of time. 此程式稱為「檔案通道」。This process is known as file tunneling. 因此, 如果您要覆寫或取代現有的檔案, 可能需要明確設定檔案的建立時間。As a result, it may be necessary to explicitly set the creation time of a file if you are overwriting or replacing an existing file.

安全性

FileIOPermission
用於設定建立時間。for setting the creation time. 相關聯的列舉:WriteAssociated enumeration: Write

適用於

另請參閱