File.GetLastWriteTimeUtc 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| GetLastWriteTimeUtc(SafeFileHandle) |
回傳指定檔案或目錄的最後寫入日期與時間，以協調世界時（UTC）為基準。 |
| GetLastWriteTimeUtc(String) |
回傳該指定檔案或目錄最後寫入的日期與時間，以協調世界時（UTC）為準。 |
GetLastWriteTimeUtc(SafeFileHandle)
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
回傳指定檔案或目錄的最後寫入日期與時間，以協調世界時（UTC）為基準。
public:
static DateTime GetLastWriteTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);public static DateTime GetLastWriteTimeUtc(Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);static member GetLastWriteTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTimePublic Shared Function GetLastWriteTimeUtc (fileHandle As SafeFileHandle) As DateTime參數
- fileHandle
- SafeFileHandle
A SafeFileHandle 是用來取得最後寫入日期與時間資訊的檔案或目錄。
傳回
一個 DateTime 設定為指定檔案或目錄最後寫入日期與時間的結構。 此值是以UTC時間表示。
例外狀況
fileHandle 是 null。
來電者沒有所需的權限。
適用於
GetLastWriteTimeUtc(String)
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
- 來源:
- File.cs
回傳該指定檔案或目錄最後寫入的日期與時間，以協調世界時（UTC）為準。
public:
static DateTime GetLastWriteTimeUtc(System::String ^ path);public static DateTime GetLastWriteTimeUtc(string path);static member GetLastWriteTimeUtc : string -> DateTimePublic Shared Function GetLastWriteTimeUtc (path As String) As DateTime參數
- path
- String
用來取得寫入日期與時間資訊的檔案或目錄。
傳回
一個 DateTime 設定為指定檔案或目錄最後寫入日期與時間的結構。 此值是以UTC時間表示。
例外狀況
來電者沒有所需的權限。
.NET Framework 與 .NET Core 版本 2.1 以前： path 為零長度字串、僅含空白，或包含一個或多個無效字元。 你可以用這個 GetInvalidPathChars() 方法查詢無效字元。
path 是 null。
指定的路徑、檔名或兩者都超過系統定義的最大長度。
path 格式無效。
備註
Note
此方法可能會回傳不準確的值，因為它使用了作業系統可能不會持續更新的原生函式。 每個作業系統依其自身規則管理最後一次寫入時間。 為了提升效能，作業系統可能不會將最後一次寫入時間設定為上一次寫入操作的精確時間，而是設定為接近的近似值。
若參數中 path 描述的檔案不存在，此方法回傳 1601 年 1 月 1 日午夜 12：00（公元曆）協調世界時（UTC）。
path參數允許指定相對或絕對路徑資訊。 相對路徑資訊會被解讀為相對於目前工作目錄的相對於。 欲取得目前的工作目錄，請參見 GetCurrentDirectory。
關於常見 I/O 任務的清單，請參見 Common I/O 任務。
