File.SetCreationTimeUtc 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

SetCreationTimeUtc(String, DateTime)	以國際標準時間 （UTC） 設定檔案建立的日期和時間。
SetCreationTimeUtc(SafeFileHandle, DateTime)	以國際標準時間設定建立檔案或目錄的日期和時間。

SetCreationTimeUtc(String, DateTime)

來源:

File.cs

以國際標準時間 （UTC） 設定檔案建立的日期和時間。

public:
 static void SetCreationTimeUtc(System::String ^ path, DateTime creationTimeUtc);

public static void SetCreationTimeUtc (string path, DateTime creationTimeUtc);

static member SetCreationTimeUtc : string * DateTime -> unit

Public Shared Sub SetCreationTimeUtc (path As String, creationTimeUtc As DateTime)

參數

path

String

要設定建立日期和時間信息的檔案。

creationTimeUtc

DateTime

要為建立日期與時間設定的值，path。 此值是以UTC時間表示。

例外狀況

FileNotFoundException

找不到指定的路徑。

ArgumentException

比 2.1 舊的 .NET Framework 和 .NET Core 版本：path 是長度為零的字串、只包含空格符，或包含一或多個無效字元。 您可以使用 GetInvalidPathChars() 方法來查詢無效的字元。

ArgumentNullException

path null。

PathTooLongException

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

IOException

執行作業時發生 I/O 錯誤。

ArgumentOutOfRangeException

creationTimeUtc 指定超出此作業允許的日期、時間或兩者範圍以外的值。

UnauthorizedAccessException

呼叫端沒有必要的許可權。

NotSupportedException

path 格式無效。

備註

path 參數可以指定相對或絕對路徑資訊。 相對路徑資訊會解譯為相對於目前工作目錄。 若要取得目前的工作目錄，請參閱 GetCurrentDirectory。

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

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• FileSystemWatcher
• 檔案和串流 I/O
• 從檔案 讀取文字
• 如何：將文字寫入檔案

SetCreationTimeUtc(SafeFileHandle, DateTime)

來源:

File.cs

以國際標準時間設定建立檔案或目錄的日期和時間。

public:
 static void SetCreationTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime creationTimeUtc);

public static void SetCreationTimeUtc (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime creationTimeUtc);

static member SetCreationTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit

Public Shared Sub SetCreationTimeUtc (fileHandle As SafeFileHandle, creationTimeUtc As DateTime)

參數

fileHandle

SafeFileHandle

要設定建立日期和時間信息的檔案或目錄 SafeFileHandle。

creationTimeUtc

DateTime

要為建立日期與時間設定的值，fileHandle。 此值是以UTC時間表示。

例外狀況

ArgumentNullException

fileHandle null。

ArgumentOutOfRangeException

creationTimeUtc 指定超出此作業允許的日期、時間或兩者範圍以外的值。

UnauthorizedAccessException

呼叫端沒有必要的許可權。

IOException

執行作業時發生 I/O 錯誤。