File.GetCreationTimeUtc メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

オーバーロード

GetCreationTimeUtc(SafeFileHandle)	指定したファイルまたはディレクトリの作成日時を協定世界時 (UTC) で返します。
GetCreationTimeUtc(String)	指定したファイルまたはディレクトリの作成日時を協定世界時 (UTC) で返します。

GetCreationTimeUtc(SafeFileHandle)

ソース:

File.cs

指定したファイルまたはディレクトリの作成日時を協定世界時 (UTC) で返します。

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

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

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

Public Shared Function GetCreationTimeUtc (fileHandle As SafeFileHandle) As DateTime

パラメーター

fileHandle

SafeFileHandle

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

戻り値

DateTime

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

例外

ArgumentNullException

fileHandle が nullです。

UnauthorizedAccessException

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

GetCreationTimeUtc(String)

ソース:

File.cs

指定したファイルまたはディレクトリの作成日時を協定世界時 (UTC) で返します。

public:
 static DateTime GetCreationTimeUtc(System::String ^ path);

public static DateTime GetCreationTimeUtc (string path);

static member GetCreationTimeUtc : string -> DateTime

Public Shared Function GetCreationTimeUtc (path As String) As DateTime

パラメーター

path

String

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

戻り値

DateTime

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

例外

UnauthorizedAccessException

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

ArgumentException

.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列、空白のみを含む、または無効な文字が 1 つ以上含まれています。 正しくない文字を照会するには、GetInvalidPathChars() メソッドを使用します。

ArgumentNullException

path が nullです。

PathTooLongException

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

NotSupportedException

path の形式が正しくありません。

例

GetCreationTimeUtcメソッドの例を次に示します。

Imports System.IO

Module Module1

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

End Module

注釈

注意

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

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

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

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

こちらもご覧ください

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