File.GetLastWriteTime(String) File.GetLastWriteTime(String) File.GetLastWriteTime(String) File.GetLastWriteTime(String) Method

定義

指定したファイルまたはディレクトリに最後に書き込んだ日付と時刻を返します。Returns the date and time the specified file or directory was last written to.

public:
 static DateTime GetLastWriteTime(System::String ^ path);
public static DateTime GetLastWriteTime (string path);
static member GetLastWriteTime : string -> DateTime
Public Shared Function GetLastWriteTime (path As String) As DateTime

パラメーター

path
String String String String

書き込み日時情報を取得する対象のファイルまたはディレクトリ。The file or directory for which to obtain write date and time information.

戻り値

指定したファイルまたはディレクトリに最後に書き込んだ日付と時刻に設定された DateTime 構造体。A DateTime structure set to the date and time that the specified file or directory was last written to. この値は現地時刻で表示されます。This value is expressed in local time.

例外

呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

path は長さ 0 の文字列であるか、空白のみで構成されるか、または InvalidPathChars で定義される 1 つ以上の使用できない文字を含んでいます。path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。The specified path, file name, or both exceed the system-defined maximum length.

path の形式が正しくありません。path is in an invalid format.

次の例はGetLastWriteTime、を示しています。The following example demonstrates GetLastWriteTime.

using namespace System;
using namespace System::IO;
int 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, 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 );
   }

}

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());
        }
    }
}
Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Try
            Dim path As String = "c:\Temp\MyTest.txt"
            If File.Exists(path) = False Then
                File.Create(path)
            Else
                ' Take some action that will affect the write time.
                File.SetLastWriteTime(path, New DateTime(1985, 4, 3))
            End If

            'Get the creation time of a well-known directory.
            Dim dt As DateTime = 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 e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

注釈

注意

このメソッドは、値がオペレーティングシステムによって継続的に更新されないネイティブ関数を使用するため、不正確な値を返す場合があります。This method may return an inaccurate value, because it uses native functions whose values may not be continuously updated by the operating system. 各オペレーティングシステムは、そのルールに従って最終書き込み時刻を管理します。Each operating system manages the last write time according to its own rules. オペレーティングシステムでは、パフォーマンスを向上させるために、最後の書き込み時刻の値が最後の書き込み操作の正確な時刻に設定されていない場合がありますが、その場合は近い近似値に設定されることがあります。To improve performance, an operating system might not set the last write time value to the exact time of the last write operation, but might set it to a close approximation instead.

pathパラメーターに記述されたファイルが存在しない場合、このメソッドは1601西暦年1月1日午前0時12:00 を返します。If the file described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. 西暦協定世界時 (UTC)。現地時刻に調整されます。(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

パラメーター pathで相対パスまたは絶対パス情報を指定できます。The path parameter is permitted to specify relative or absolute path information. 相対パス情報は、現在の作業ディレクトリを基準として解釈されます。Relative path information is interpreted as relative to the current working directory. 現在の作業ディレクトリを取得するにGetCurrentDirectoryは、「」を参照してください。To obtain the current working directory, see GetCurrentDirectory.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

セキュリティ

FileIOPermission
指定されたファイルから読み取りを行う場合。for reading from the specified file. 関連付けられた列挙型:ReadAssociated enumeration: Read

適用対象

こちらもご覧ください