FileSystemInfo.CreationTime 屬性

  • 參考

定義

命名空間:
System.IO
組件:
mscorlib.dll, System.IO.FileSystem.dll
組件:
System.IO.FileSystem.dll
組件:
System.Runtime.dll
組件:
mscorlib.dll
組件:
netstandard.dll
來源:
FileSystemInfo.cs
來源:
FileSystemInfo.cs
來源:
FileSystemInfo.cs

取得或設定目前檔案或目錄的建立時間。

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

屬性值

DateTime

目前 FileSystemInfo 物件的建立日期和時間。

例外狀況

IOException

Refresh() 無法初始化資料。

DirectoryNotFoundException

指定的路徑無效；例如，位於未對應的磁碟上。

PlatformNotSupportedException

目前的作業系統不是 Windows NT 或更新版本。

ArgumentOutOfRangeException

呼叫端嘗試設定無效的建立時間。

範例

下列範例示範 CreationTime 屬性。 此程式代碼範例是針對 類別提供的較大範例的 FileSystemInfo 一部分。

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

備註

注意

這個方法可能會傳回不正確的值，因為它會使用操作系統可能不會持續更新其值的原生函式。

如果物件的目前實例FileSystemInfo從下列DirectoryInfo任一方法傳回，則會預先快取 屬性的值CreationTime：

若要取得最新的值，請呼叫 Refresh 方法。

如果物件中所述的 FileSystemInfo 檔案不存在，則此屬性會傳回 12：00 午夜，1601 A.D. (C.E.) 國際標準時間 (UTC) ，調整為當地時間。

在不支援建立或出生日期的 Unix 平臺上，這個屬性會傳回上次狀態變更的較舊時間，以及上次修改的時間。 在其他平臺上，它會傳回上午 12：00,1601 A.D. (C.E.) 國際標準時間 (UTC) ，調整為當地時間。

NTFS 格式的磁碟驅動器可能會快取檔案中繼資訊，例如檔案建立時間短時間。 此程序稱為檔案通道。 因此，如果您要覆寫或取代現有的檔案，可能需要明確設定檔案的建立時間。

適用於

另請參閱