File.GetCreationTimeUtc メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 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 -> DateTimePublic Shared Function GetCreationTimeUtc (fileHandle As SafeFileHandle) As DateTimeパラメーター
- fileHandle
- SafeFileHandle
SafeFileHandle作成日時情報を取得するファイルまたはディレクトリの 。
戻り値
指定したファイルまたはディレクトリの作成日時に設定された DateTime 構造体。 この値は UTC 時刻で表記されます。
例外
fileHandle が nullです。
呼び出し元に、必要なアクセス許可がありません。
適用対象
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 -> DateTimePublic Shared Function GetCreationTimeUtc (path As String) As DateTimeパラメーター
- path
- String
作成日時情報を取得する対象のファイルまたはディレクトリ。
戻り値
指定したファイルまたはディレクトリの作成日時に設定された DateTime 構造体。 この値は UTC 時刻で表記されます。
例外
呼び出し元に、必要なアクセス許可がありません。
.NET Framework バージョンと .NET Core バージョンが 2.1 より前の場合: path は長さ 0 の文字列、空白のみを含む、または無効な文字が 1 つ以上含まれています。 正しくない文字を照会するには、GetInvalidPathChars() メソッドを使用します。
path が nullです。
指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。
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 タスク を参照してください。
こちらもご覧ください
適用対象
.NET