File.SetCreationTimeUtc 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

重载

SetCreationTimeUtc(String, DateTime)	以协调世界时（UTC）设置文件的创建日期和时间。
SetCreationTimeUtc(SafeFileHandle, DateTime)	设置创建文件或目录的日期和时间（UTC）。

SetCreationTimeUtc(String, DateTime)

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

要为 path的创建日期和时间设置的值。 此值以 UTC 时间表示。

例外

FileNotFoundException

找不到指定的路径。

ArgumentException

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

ArgumentNullException

path null。

PathTooLongException

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

IOException

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

ArgumentOutOfRangeException

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

UnauthorizedAccessException

调用方没有所需的权限。

NotSupportedException

path 格式无效。

注解

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

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

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

另请参阅

• FileSystemWatcher
• 文件和流 I/O
• 从文件 读取文本
• 如何：将文本写入文件

SetCreationTimeUtc(SafeFileHandle, DateTime)

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

要为 fileHandle的创建日期和时间设置的值。 此值以 UTC 时间表示。

例外

ArgumentNullException

fileHandle null。

ArgumentOutOfRangeException

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

UnauthorizedAccessException

调用方没有所需的权限。

IOException

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