File.GetCreationTime メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

オーバーロード

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

GetCreationTime(SafeFileHandle)

ソース:

File.cs

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

public:
 static DateTime GetCreationTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static DateTime GetCreationTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetCreationTime : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime

Public Shared Function GetCreationTime (fileHandle As SafeFileHandle) As DateTime

パラメーター

fileHandle

SafeFileHandle

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

戻り値

DateTime

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

例外

ArgumentNullException

fileHandle が nullです。

UnauthorizedAccessException

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

GetCreationTime(String)

ソース:

File.cs

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

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

注釈

注意

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

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

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

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

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

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