英語で読む

次の方法で共有


File.GetLastWriteTime メソッド

定義

オーバーロード

GetLastWriteTime(SafeFileHandle)

指定したファイルまたはディレクトリの最後の書き込み日時を返します。

GetLastWriteTime(String)

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

GetLastWriteTime(SafeFileHandle)

ソース:
File.cs
ソース:
File.cs
ソース:
File.cs

指定したファイルまたはディレクトリの最後の書き込み日時を返します。

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

パラメーター

fileHandle
SafeFileHandle

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

戻り値

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

例外

fileHandlenullです。

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

適用対象

.NET 10 およびその他のバージョン
製品 バージョン
.NET 7, 8, 9, 10

GetLastWriteTime(String)

ソース:
File.cs
ソース:
File.cs
ソース:
File.cs

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

public static DateTime GetLastWriteTime(string path);

パラメーター

path
String

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

戻り値

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

例外

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

.NET Framework および .NET Core バージョン 2.1 より前: path は長さ 0 の文字列で、空白のみを含むか、1 つ以上の無効な文字を含みます。 GetInvalidPathChars() メソッドを使用して、無効な文字を照会できます。

pathnullです。

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

path が無効な形式です。

次の例では、GetLastWriteTimeを示します。

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            string path = @"c:\Temp\MyTest.txt";
            if (!File.Exists(path))
            {
                File.Create(path);
            }
            else
            {
                // Take an action that will affect the write time.
                File.SetLastWriteTime(path, new DateTime(1985,4,3));
            }

            // Get the creation time of a well-known directory.
            DateTime dt = File.GetLastWriteTime(path);
            Console.WriteLine("The last write time for this file was {0}.", dt);
            
            // Update the last write time.
            File.SetLastWriteTime(path, DateTime.Now);
            dt = File.GetLastWriteTime(path);
            Console.WriteLine("The last write time for this file was {0}.", dt);
        }

        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

注釈

注意

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

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

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

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

適用対象

.NET 10 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0