File.SetLastWriteTime メソッド

[アーティクル]
03/28/2008

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

Public Shared Sub SetLastWriteTime( _
   ByVal path As String, _   ByVal lastWriteTime As DateTime _)
[C#]
public static void SetLastWriteTime(stringpath,DateTimelastWriteTime);
[C++]
public: static void SetLastWriteTime(String* path,DateTimelastWriteTime);
[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 の形式が無効です。

解説

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

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

実行するタスク	参考例があるトピック
テキストファイルに書き込む。	ファイルへのテキストの書き込み
テキストファイルから読み取る。	ファイルからのテキストの読み取り
テキストをファイルに追加する。	ログファイルのオープンと追加 File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo

使用例

[Visual Basic, C#, C++] ファイルシステムに指定したファイルがあるかどうかをチェックし、必要に応じてファイルを作成し、ファイルに最後に書き込んだ時刻を設定および取得する例を次に示します。

 
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 <mscorlib.dll>

using namespace System;
using namespace System::IO;

int main() {
    try {
        String* path = S"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(S"The last write time for this file was {0}.", __box(dt));

        // Update the last write time.
        File::SetLastWriteTime(path, DateTime::Now);
        dt = File::GetLastWriteTime(path);
        Console::WriteLine(S"The last write time for this file was {0}.", __box(dt));
    } catch (Exception* e) {
        Console::WriteLine(S"The process failed: {0}", e);
    }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, Common Language Infrastructure (CLI) Standard

.NET Framework セキュリティ:

FileIOPermission 。 FileIOPermissionAccess.Write (関連する列挙体)

参照

次の方法で共有

File.SetLastWriteTime メソッド

パラメータ

例外

解説

使用例

必要条件

参照

その他のリソース