File.SetLastWriteTime メソッド

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

File.SetLastWriteTime メソッド

指定したファイルに最後に書き込んだ日付と時刻を設定します。

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

Visual Basic (宣言)

Public Shared Sub SetLastWriteTime
 ( _
    path As String, _
    lastWriteTime As DateTime _
)

Visual Basic (使用法)

Dim path As String
Dim lastWriteTime As DateTime

File.SetLastWriteTime(path, lastWriteTime)

C#

public static void SetLastWriteTime
 (
    string path,
    DateTime lastWriteTime
)

C++

public:
static void SetLastWriteTime (
    String^ path, 
    DateTime lastWriteTime
)

J#

public static void SetLastWriteTime
 (
    String path, 
    DateTime lastWriteTime
)

JScript

public static function SetLastWriteTime
 (
    path : String, 
    lastWriteTime : DateTime
)

パラメータ

path

日時情報を設定する対象のファイル。

lastWriteTime

path に最後に書き込んだ日付と時刻の設定値を含む DateTime。この値は現地時刻で表示されます。

例外

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

解説

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)
            Else
                ' Take an 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

C#

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());
        }
    }
}

C++

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 );
   }

}

J#

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);
            }
            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.get_Now());
            dt = File.GetLastWriteTime(path);
            Console.WriteLine("The last write time for this
 file was {0}.",
                dt);
        }
        catch (System.Exception e) {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    } //main
} //Test

.NET Framework のセキュリティ

• FileIOPermission  (指定したファイルに書き込むために必要なアクセス許可)。FileIOPermissionAccess.Write (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
File クラス
File メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む