File.GetLastAccessTimeUtc 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

GetLastAccessTimeUtc(SafeFileHandle)	傳回指定檔案或目錄之 UTC (UTC) 的最後一次存取日期和時間。
GetLastAccessTimeUtc(String)	傳回上次存取指定檔案或目錄的日期和時間，以國際標準時間 (UTC) 。

GetLastAccessTimeUtc(SafeFileHandle)

來源:

File.cs

傳回指定檔案或目錄之 UTC (UTC) 的最後一次存取日期和時間。

public:
 static DateTime GetLastAccessTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static DateTime GetLastAccessTimeUtc (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetLastAccessTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime

Public Shared Function GetLastAccessTimeUtc (fileHandle As SafeFileHandle) As DateTime

參數

fileHandle

SafeFileHandle

SafeFileHandle要取得上次存取日期和時間資訊的檔案或目錄的 。

傳回

DateTime

結構 DateTime 會設定為指定之檔案或目錄的上次存取日期和時間。 這個值以 UTC 時間表示。

例外狀況

ArgumentNullException

fileHandle 為 null。

UnauthorizedAccessException

呼叫端沒有必要的權限。

GetLastAccessTimeUtc(String)

來源:

File.cs

傳回上次存取指定檔案或目錄的日期和時間，以國際標準時間 (UTC) 。

public:
 static DateTime GetLastAccessTimeUtc(System::String ^ path);

public static DateTime GetLastAccessTimeUtc (string path);

static member GetLastAccessTimeUtc : string -> DateTime

Public Shared Function GetLastAccessTimeUtc (path As String) As DateTime

參數

path

String

要取得其存取日期和時間資訊的檔案或目錄。

傳回

DateTime

DateTime 結構，設定為指定檔案或目錄的上次存取日期和時間。 這個值以 UTC 時間表示。

例外狀況

UnauthorizedAccessException

呼叫端沒有必要的權限。

ArgumentException

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

ArgumentNullException

path 為 null。

PathTooLongException

指定的路徑、檔案名稱，或兩者都超出系統定義的長度上限。

NotSupportedException

path 格式無效。

備註

注意

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

如果 參數中所述的 path 檔案不存在，這個方法會傳回 12：00 A.1601 A.D. (C.E.) Coordinated Universal Time (UTC) 。

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

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

另請參閱

• FileSystemWatcher
• 檔案和資料流程 I/O
• 從檔案讀取文字
• 作法：將文字寫入檔案