File.SetCreationTimeUtc 方法

定义

命名空间:: System.IO

程序集:: mscorlib.dll, System.IO.FileSystem.dll

程序集:: netstandard.dll, System.Runtime.dll

程序集:: netstandard.dll, System.IO.FileSystem.dll

程序集:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

程序集:: System.IO.FileSystem.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

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

SetCreationTimeUtc(String, DateTime)

Source:: File.cs

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

要为 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 任务。

另请参阅

适用于

SetCreationTimeUtc(SafeFileHandle, DateTime)

Source:: File.cs

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

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

例外