File.GetCreationTime(String) メソッド

定義

名前空間:
System.IO
アセンブリ:
mscorlib.dll, System.IO.FileSystem.dll
アセンブリ:
mscorlib.dll
アセンブリ:
System.IO.FileSystem.dll
アセンブリ:
netstandard.dll

指定したファイルまたはディレクトリの作成日時を返します。

public:
 static DateTime GetCreationTime(System::String ^ path);
public static DateTime GetCreationTime(string path);
static member GetCreationTime : string -> DateTime
Public Shared Function GetCreationTime (path As String) As DateTime

パラメーター

path
String

作成日時情報を取得するファイルまたはディレクトリ。

返品

DateTime

指定したファイルまたはディレクトリの作成日時に設定された DateTime 構造体。 この値は現地時刻で表されます。

例外

UnauthorizedAccessException

呼び出し元に必要なアクセス許可がありません。

ArgumentException

2.1 より前のバージョンの .NET Framework と .NET Core: path は長さ 0 の文字列で、空白のみを含むか、1 つ以上の無効な文字を含みます。 GetInvalidPathChars() メソッドを使用して、無効な文字のクエリを実行できます。

ArgumentNullException

path は nullです。

PathTooLongException

指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。

NotSupportedException

path が無効な形式です。

例

次の例では、 GetCreationTimeを示します。

Imports System.IO

Module Module1

    Sub Main()
        Dim fileCreatedDate As DateTime = File.GetCreationTime("C:\Example\MyTest.txt")
        Console.WriteLine("file created: " + fileCreatedDate)
    End Sub

End Module

注釈

Note

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

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

path パラメーターに記述されているファイルが存在しない場合、このメソッドは 1601 年 1 月 1 日午前 12 時 00 分 (C.E.) を返します。協定世界時 (UTC)、現地時刻に調整されます。

NTFS 形式のドライブは、ファイルの作成時間などのファイルに関する情報を短期間キャッシュする場合があります。 その結果、既存のファイルを上書きまたは置き換える場合は、ファイルの作成時刻を明示的に設定する必要があります。

一般的な I/O タスクの一覧については、「 一般的な I/O タスク」を参照してください。

適用対象

こちらもご覧ください