File.GetCreationTimeUtc メソッド

定義

オーバーロード

GetCreationTimeUtc(SafeFileHandle)

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

GetCreationTimeUtc(String)

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

GetCreationTimeUtc(SafeFileHandle)

ソース:
File.cs
ソース:
File.cs
ソース:
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 構造体。 この値は UTC 時刻で表記されます。

例外

fileHandlenullです。

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

適用対象

GetCreationTimeUtc(String)

ソース:
File.cs
ソース:
File.cs
ソース:
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 構造体。 この値は UTC 時刻で表記されます。

例外

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

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

pathnullです。

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

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 タスク を参照してください。

こちらもご覧ください

適用対象