File.SetCreationTimeUtc メソッド
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SetCreationTimeUtc(String, DateTime) |
ファイルが作成された日付と時刻を協定世界時 (UTC) で設定します。 |
SetCreationTimeUtc(SafeFileHandle, DateTime) |
ファイルまたはディレクトリが作成された日付と時刻を協定世界時 (UTC) で設定します。 |
- ソース:
- File.cs
- ソース:
- File.cs
- ソース:
- File.cs
ファイルが作成された日付と時刻を協定世界時 (UTC) で設定します。
public:
static void SetCreationTimeUtc(System::String ^ path, DateTime creationTimeUtc);
public static void SetCreationTimeUtc (string path, DateTime creationTimeUtc);
static member SetCreationTimeUtc : string * DateTime -> unit
Public Shared Sub SetCreationTimeUtc (path As String, creationTimeUtc As DateTime)
パラメーター
- path
- String
作成日時情報を設定するファイル。
- creationTimeUtc
- DateTime
path
の作成日時に設定する値。 この値は UTC 時刻で表されます。
例外
指定したパスが見つかりませんでした。
.NET Framework および .NET Core バージョン 2.1 より前: path
は長さ 0 の文字列で、空白のみを含むか、1 つ以上の無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字を照会できます。
path
は null
です。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。
操作の実行中に I/O エラーが発生しました。
creationTimeUtc
は、この操作で許可される日付、時刻、またはその両方の範囲外の値を指定します。
呼び出し元に必要なアクセス許可がありません。
path
が無効な形式です。
注釈
path
パラメーターは、相対パス情報または絶対パス情報を指定できます。 相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。 現在の作業ディレクトリを取得するには、GetCurrentDirectoryを参照してください。
NTFS 形式のドライブでは、ファイルの作成時間などのファイル メタ情報が短期間キャッシュされる場合があります。 その結果、既存のファイルを上書きまたは置き換える場合は、ファイルの作成時刻を明示的に設定する必要があります。
一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。
こちらもご覧ください
- FileSystemWatcher
- ファイルおよびストリーム I/O
- ファイル からテキストを読み取る
- 方法: ファイル にテキストを書き込む
適用対象
.NET 9 およびその他のバージョン
製品 | バージョン |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
- ソース:
- File.cs
- ソース:
- File.cs
- ソース:
- File.cs
ファイルまたはディレクトリが作成された日付と時刻を協定世界時 (UTC) で設定します。
public:
static void SetCreationTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime creationTimeUtc);
public static void SetCreationTimeUtc (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime creationTimeUtc);
static member SetCreationTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit
Public Shared Sub SetCreationTimeUtc (fileHandle As SafeFileHandle, creationTimeUtc As DateTime)
パラメーター
- fileHandle
- SafeFileHandle
作成日時情報を設定するファイルまたはディレクトリへの SafeFileHandle。
- creationTimeUtc
- DateTime
fileHandle
の作成日時に設定する値。 この値は UTC 時刻で表されます。
例外
fileHandle
は null
です。
creationTimeUtc
は、この操作で許可される日付、時刻、またはその両方の範囲外の値を指定します。
呼び出し元に必要なアクセス許可がありません。
操作の実行中に I/O エラーが発生しました。
適用対象
.NET 9 およびその他のバージョン
製品 | バージョン |
---|---|
.NET | 7, 8, 9 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。