FileSystemInfo.CreationTime プロパティ

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

ソース:

FileSystemInfo.cs

現在のファイルまたはディレクトリの作成日時を取得または設定します。

public:
 property DateTime CreationTime { DateTime get(); void set(DateTime value); };

public DateTime CreationTime { get; set; }

member this.CreationTime : DateTime with get, set

Public Property CreationTime As DateTime

プロパティ値

DateTime

現在の FileSystemInfo オブジェクトの日時。

例外

IOException

Refresh() がデータを初期化できません。

DirectoryNotFoundException

指定したパスが無効です (割り当てられていないドライブであるなど)。

PlatformNotSupportedException

現在のオペレーティング システムは Windows NT 以降ではありません。

ArgumentOutOfRangeException

呼び出し元が、無効な作成時間を設定しようとしています。

例

CreationTimeプロパティの例を次に示します。 このコード例は、FileSystemInfo クラスのために提供されている大規模な例の一部です。

static void DisplayFileSystemInfoAttributes(FileSystemInfo^ fsi)
{
    //  Assume that this entry is a file.
    String^ entryType = "File";

    // Determine if entry is really a directory
    if ((fsi->Attributes & FileAttributes::Directory) == FileAttributes::Directory)
    {
        entryType = "Directory";
    }
    //  Show this entry's type, name, and creation date.
    Console::WriteLine("{0} entry {1} was created on {2:D}", entryType, fsi->FullName, fsi->CreationTime);
}

static void DisplayFileSystemInfoAttributes(FileSystemInfo fsi)
{
    //  Assume that this entry is a file.
    string entryType = "File";

    // Determine if entry is really a directory
    if ((fsi.Attributes & FileAttributes.Directory) == FileAttributes.Directory )
    {
        entryType = "Directory";
    }
    //  Show this entry's type, name, and creation date.
    Console.WriteLine("{0} entry {1} was created on {2:D}", entryType, fsi.FullName, fsi.CreationTime);
}

Sub DisplayFileSystemInfoAttributes(ByVal fsi As IO.FileSystemInfo)
    ' Assume that this entry is a file.
    Dim entryType As String = "File"

    ' Determine if this entry is really a directory.
    If (fsi.Attributes And FileAttributes.Directory) = FileAttributes.Directory Then
        entryType = "Directory"
    End If

    ' Show this entry's type, name, and creation date.
    Console.WriteLine("{0} entry {1} was created on {2:D}", _
        entryType, fsi.FullName, fsi.CreationTime)
End Sub

注釈

注意

このメソッドは、オペレーティング システムによって値が継続的に更新されないネイティブ関数を使用するため、不正確な値を返す可能性があります。

オブジェクトの現在のCreationTimeインスタンスが次DirectoryInfoのいずれかのメソッドから返された場合、FileSystemInfoプロパティの値は事前にキャッシュされます。

• DirectoryInfo.GetDirectories

• DirectoryInfo.GetFiles

• DirectoryInfo.GetFileSystemInfos

• DirectoryInfo.EnumerateDirectories

• DirectoryInfo.EnumerateFiles

• DirectoryInfo.EnumerateFileSystemInfos

最新の値を取得するには、 メソッドを呼び出します Refresh 。

オブジェクトに FileSystemInfo 記述されているファイルが存在しない場合、このプロパティは 1601 年 1 月 1 日午前 0 時 00 分 (C.E.) を返します。協定世界時 (UTC) で、現地時刻に調整されます。

作成または誕生時刻をサポートしていない Unix プラットフォームでは、このプロパティは、前回の状態変更の古い時刻と最後の変更時刻を返します。 他のプラットフォームでは、1601 年 1 月 1 日午前 0 時 00 分 (C.E.) を返します協定世界時 (UTC) で、現地時刻に調整されます。

NTFS 形式のドライブでは、ファイルの作成時間などのファイル メタ情報が短時間キャッシュされる場合があります。 このプロセスは、ファイル トンネリングと呼ばれます。 その結果、既存のファイルを上書きまたは置き換える場合は、ファイルの作成時間を明示的に設定することが必要になる場合があります。

こちらもご覧ください

• FileSystemWatcher
• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み