File.SetLastAccessTime メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

File.SetLastAccessTime メソッド

指定したファイルに最後にアクセスした日付と時刻を設定します。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub SetLastAccessTime
 ( _
    path As String, _
    lastAccessTime As DateTime _
)

Visual Basic (使用法)

Dim path As String
Dim lastAccessTime As DateTime

File.SetLastAccessTime(path, lastAccessTime)

public static void SetLastAccessTime
 (
    string path,
    DateTime lastAccessTime
)

C++

public:
static void SetLastAccessTime (
    String^ path, 
    DateTime lastAccessTime
)

public static void SetLastAccessTime
 (
    String path, 
    DateTime lastAccessTime
)

JScript

public static function SetLastAccessTime
 (
    path : String, 
    lastAccessTime : DateTime
)

パラメータ

path: アクセス日時情報を設定する対象のファイル。

lastAccessTime: path に最後にアクセスした日付と時刻の設定値を含む DateTime。この値は現地時刻で表示されます。

例外

例外の種類	条件
ArgumentException	path が、長さが 0 の文字列であるか、空白しか含んでいないか、または InvalidPathChars で定義されている無効な文字を 1 つ以上含んでいます。
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。
FileNotFoundException	指定したパスが見つかりませんでした。
UnauthorizedAccessException	呼び出し元に、必要なアクセス許可がありません。
NotSupportedException	path の形式が無効です。
ArgumentOutOfRangeException	lastAccessTime は、この操作で許可される日付または時刻の範囲を超える値を指定します。

解説

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

このメソッドの使用例については、「使用例」を参照してください。その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo

使用例

ファイルシステムに指定したファイルがあるかどうかをチェックし、必要に応じてそれを作成し、最後にアクセスした時刻を設定および取得する例を次に示します。

Visual Basic

Imports System
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)
            End If
            File.SetLastAccessTime(path, New DateTime(1985, 5,
 4))

            ' Get the creation time of a well-known directory.
            Dim dt As DateTime = File.GetLastAccessTime(path)
            Console.WriteLine("The last access time for this file
 was {0}.", dt)

            ' Update the last access time.
            File.SetLastAccessTime(path, DateTime.Now)
            dt = File.GetLastAccessTime(path)
            Console.WriteLine("The last access 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

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);
                // Update the last access time.    
            }
            File.SetLastAccessTime(path, new DateTime(1985,5,4));

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

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

C++

using namespace System;
using namespace System::IO;
int main()
{
   try
   {
      String^ path = "c:\\Temp\\MyTest.txt";
      if (  !File::Exists( path ) )
      {
         File::Create( path );
         
         // Update the last access time.    
      }
      File::SetLastAccessTime( path, DateTime(1985,5,4) );
      
      // Get the creation time of a well-known directory.
      DateTime dt = File::GetLastAccessTime( path );
      Console::WriteLine( "The last access time for this
 file was {0}.", dt );
      
      // Update the last access time.
      File::SetLastAccessTime( path, DateTime::Now );
      dt = File::GetLastAccessTime( path );
      Console::WriteLine( "The last access time for this
 file was {0}.", dt );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }

}

import System.*;
import System.IO.*;

class Test
{
    public static void main(String[]
 args)
    {
        try {
            String path = "c:\\Temp\\MyTest.txt";

            if (!(File.Exists(path))) {
                File.Create(path);
            }

            // Update the last access time.    
            File.SetLastAccessTime(path, new DateTime(1985, 5,
 4));

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

            // Update the last access time.
            File.SetLastAccessTime(path, DateTime.get_Now());
            dt = File.GetLastAccessTime(path);
            Console.WriteLine("The last access time for this
 file was {0}.",
                dt);
        }
        catch (System.Exception e) {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    } //main
} //Test