File.GetLastWriteTimeUtc メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

オーバーロード

GetLastWriteTimeUtc(SafeFileHandle)	指定したファイルまたはディレクトリの最終書き込み日時を協定世界時 (UTC) で返します。
GetLastWriteTimeUtc(String)	指定したファイルまたはディレクトリが最後に書き込まれた日時を協定世界時 (UTC) で返します。

GetLastWriteTimeUtc(SafeFileHandle)

ソース:

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 -> DateTime

Public Shared Function GetLastWriteTimeUtc (fileHandle As SafeFileHandle) As DateTime

パラメーター

fileHandle

SafeFileHandle

SafeFileHandle最終書き込み日時情報を取得するファイルまたはディレクトリの 。

戻り値

DateTime

DateTime指定したファイルまたはディレクトリの最後の書き込み日時に設定された構造体。 この値は UTC 時刻で表記されます。

例外

ArgumentNullException

fileHandle が nullです。

UnauthorizedAccessException

呼び出し元に、必要なアクセス許可がありません。

GetLastWriteTimeUtc(String)

ソース:

File.cs

指定したファイルまたはディレクトリが最後に書き込まれた日時を協定世界時 (UTC) で返します。

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

public static DateTime GetLastWriteTimeUtc (string path);

static member GetLastWriteTimeUtc : string -> DateTime

Public Shared Function GetLastWriteTimeUtc (path As String) As DateTime

パラメーター

path

String

書き込み日時情報を取得する対象のファイルまたはディレクトリ。

戻り値

DateTime

指定したファイルまたはディレクトリに最後に書き込んだ日付と時刻に設定された DateTime 構造体。 この値は UTC 時刻で表記されます。

例外

UnauthorizedAccessException

呼び出し元に、必要なアクセス許可がありません。

ArgumentException

.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列、空白のみを含む、または無効な文字が 1 つ以上含まれています。 正しくない文字を照会するには、GetInvalidPathChars() メソッドを使用します。

ArgumentNullException

path が nullです。

PathTooLongException

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。

NotSupportedException

path の形式が正しくありません。

注釈

注意

このメソッドは、オペレーティング システムによって値が継続的に更新されないネイティブ関数を使用するため、不正確な値を返す可能性があります。 各オペレーティング システムは、独自の規則に従って最後の書き込み時刻を管理します。 パフォーマンスを向上させるために、オペレーティング システムは最後の書き込み時間の値を最後の書き込み操作の正確な時刻に設定せず、代わりに近似値に設定する場合があります。

パラメーターに path 記述されているファイルが存在しない場合、このメソッドは午前 12 時 00 分、午前 1 時 1601 日午前 1 時 (C.E.) を返します。協定世界時 (UTC)。

パラメーターは path 、相対パス情報または絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。 現在の作業ディレクトリを取得するには、「」を参照してください GetCurrentDirectory。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

• FileSystemWatcher
• ファイルおよびストリーム入出力
• ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み