FileSystemInfo.CreationTime プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のファイルまたはディレクトリの作成時刻を取得または設定します。
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
プロパティ値
現在の FileSystemInfo オブジェクトの作成日時。
例外
Refresh() では、データを初期化できません。
指定されたパスが無効です。たとえば、マップされていないドライブ上にあります。
現在のオペレーティング システムが Windows NT 以降ではありません。
呼び出し元が無効な作成時刻の設定を試みます。
例
次の例では、 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);
}
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
注釈
注
このメソッドは、オペレーティング システムによって値が継続的に更新されないネイティブ関数を使用するため、不正確な値を返す可能性があります。
FileSystemInfo オブジェクトの現在のインスタンスが次のいずれかのDirectoryInfo メソッドから返された場合、CreationTime プロパティの値は事前キャッシュされます。
最新の値を取得するには、 Refresh メソッドを呼び出します。
FileSystemInfo オブジェクトに記述されているファイルが存在しない場合、このプロパティは 1601 年 1 月 1 日午前 12 時 00 分 (C.E.) を返します。協定世界時 (UTC)、現地時刻に調整されます。
作成時間または生年月日をサポートしていない Unix プラットフォームでは、このプロパティは、前回の状態変更時刻と最終変更時刻を返します。 他のプラットフォームでは、1601 年 1 月 1 日午前 0 時 00 分 (C.E.) が返されます。協定世界時 (UTC)、現地時刻に調整されます。
NTFS 形式のドライブでは、ファイルの作成時間などのファイル メタ情報が短期間キャッシュされる場合があります。 このプロセスは、ファイル トンネリングと呼ばれます。 その結果、既存のファイルを上書きまたは置き換える場合は、ファイルの作成時刻を明示的に設定する必要があります。