語言

File.GetCreationTimeUtc 方法

定義

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

多載

名稱 Description
GetCreationTimeUtc(SafeFileHandle)

回傳指定檔案或目錄的建立日期與時間，以協調世界時（UTC）為基準。
GetCreationTimeUtc(String)

回傳指定檔案或目錄的建立日期與時間，以協調世界時（UTC）為基準。

GetCreationTimeUtc(SafeFileHandle)

來源:
File.cs
來源:
File.cs
來源:
File.cs
來源:
File.cs
來源:
File.cs

回傳指定檔案或目錄的建立日期與時間，以協調世界時（UTC）為基準。

public:
 static DateTime GetCreationTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);
public static DateTime GetCreationTimeUtc(Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);
static member GetCreationTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime
Public Shared Function GetCreationTimeUtc (fileHandle As SafeFileHandle) As DateTime

參數

fileHandle
SafeFileHandle

SafeFileHandle A 是用來取得建立日期與時間資訊的檔案或目錄。

傳回

DateTime

一個 DateTime 設定為指定檔案或目錄建立日期與時間的結構。 此值是以UTC時間表示。

例外狀況

ArgumentNullException

fileHandle 是 null。

UnauthorizedAccessException

來電者沒有所需的權限。

適用於

GetCreationTimeUtc(String)

來源:
File.cs
來源:
File.cs
來源:
File.cs
來源:
File.cs
來源:
File.cs

回傳指定檔案或目錄的建立日期與時間，以協調世界時（UTC）為基準。

public:
 static DateTime GetCreationTimeUtc(System::String ^ path);
public static DateTime GetCreationTimeUtc(string path);
static member GetCreationTimeUtc : string -> DateTime
Public Shared Function GetCreationTimeUtc (path As String) As DateTime

參數

path
String

用來取得建立日期與時間資訊的檔案或目錄。

傳回

DateTime

一個 DateTime 設定為指定檔案或目錄建立日期與時間的結構。 此值是以UTC時間表示。

例外狀況

UnauthorizedAccessException

來電者沒有所需的權限。

ArgumentException

.NET Framework 與 .NET Core 版本 2.1 以前： path 為零長度字串、僅含空白，或包含一個或多個無效字元。 你可以用這個 GetInvalidPathChars() 方法查詢無效字元。

ArgumentNullException

path 是 null。

PathTooLongException

指定的路徑、檔名或兩者都超過系統定義的最大長度。

NotSupportedException

path 格式無效。

範例

以下範例示範此 GetCreationTimeUtc 方法。

Imports System.IO

Module Module1

    Sub Main()
        Dim fileCreatedDate As DateTime = File.GetCreationTimeUtc("C:\Example\MyTest.txt")
        Console.WriteLine("file created: " + fileCreatedDate)
    End Sub

End Module

備註

Note

此方法可能會回傳不準確的值，因為它使用了作業系統可能不會持續更新的原生函式。

若參數中 path 描述的檔案不存在，此方法回傳 1601 年 1 月 1 日午夜 12：00（公元曆）協調世界時（UTC）。

NTFS 格式的硬碟可能會在短時間內快取檔案資訊，例如檔案建立時間。 因此，如果您要覆寫或取代現有的檔案，可能需要明確設定檔案的建立時間。

關於常見 I/O 任務的清單，請參見 Common I/O 任務。

另請參閱

適用於