File.SetCreationTimeUtc 方法

定义

重载

SetCreationTimeUtc(String, DateTime)

以协调世界时(UTC)设置文件的创建日期和时间。

SetCreationTimeUtc(SafeFileHandle, DateTime)

设置创建文件或目录的日期和时间(UTC)。

SetCreationTimeUtc(String, DateTime)

Source:
File.cs
Source:
File.cs
Source:
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

一个 DateTime,包含要为创建日期和时间设置 path的值。 此值以 UTC 时间表示。

例外

找不到指定的路径。

低于 2.1 的 .NET Framework 和 .NET Core 版本:path 为零长度的字符串,仅包含空格,或包含一个或多个无效字符。 可以使用 GetInvalidPathChars() 方法查询无效字符。

path null

指定的路径、文件名或两者都超过了系统定义的最大长度。

执行操作时发生 I/O 错误。

creationTime 指定超出此操作允许的日期、时间或两者范围之外的值。

调用方没有所需的权限。

path 格式无效。

注解

允许 path 参数指定相对路径或绝对路径信息。 相对路径信息解释为相对于当前工作目录。 若要获取当前工作目录,请参阅 GetCurrentDirectory

NTFS 格式的驱动器可能会在短时间内缓存文件元信息,例如文件创建时间。 因此,如果要覆盖或替换现有文件,则可能需要显式设置文件的创建时间。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务

另请参阅

适用于

SetCreationTimeUtc(SafeFileHandle, DateTime)

Source:
File.cs
Source:
File.cs
Source:
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

一个 DateTime,包含要为创建日期和时间设置 fileHandle的值。 此值以 UTC 时间表示。

例外

fileHandle null

creationTimeUtc 指定超出此操作允许的日期、时间或两者范围之外的值。

调用方没有所需的权限。

执行操作时发生 I/O 错误。

适用于