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