File.SetCreationTimeUtc 方法

设置文件创建的日期和时间，其格式为协调通用时间 (UTC)。

**命名空间:**System.IO
**程序集:**mscorlib（在 mscorlib.dll 中）

语法

声明
Public Shared Sub SetCreationTimeUtc ( _
    path As String, _
    creationTimeUtc As DateTime _
)
用法
Dim path As String
Dim creationTimeUtc As DateTime

File.SetCreationTimeUtc(path, creationTimeUtc)

public static void SetCreationTimeUtc (
    string path,
    DateTime creationTimeUtc
)

public:
static void SetCreationTimeUtc (
    String^ path, 
    DateTime creationTimeUtc
)

public static void SetCreationTimeUtc (
    String path, 
    DateTime creationTimeUtc
)

public static function SetCreationTimeUtc (
    path : String, 
    creationTimeUtc : DateTime
)

参数

• path
  要设置其创建日期和时间信息的文件。

• creationTimeUtc
  DateTime，它包含要为 path 的创建日期和时间设置的值。该值用 UTC 时间表示。

异常

异常类型	条件
FileNotFoundException	未找到指定的路径。
ArgumentException	path 是一个零长度字符串，仅包含空白或者包含一个或多个由 InvalidPathChars 定义的无效字符。
ArgumentNullException	path 为 空引用（在 Visual Basic 中为 Nothing）。
PathTooLongException	指定的路径、文件名或者两者都超出了系统定义的最大长度。例如，在基于 Windows 的平台上，路径必须小于 248 个字符，文件名必须小于 260 个字符。
IOException	执行操作时发生 I/O 错误。
ArgumentOutOfRangeException	creationTime 指定的值超出了该操作所允许的日期范围或时间范围，或同时超出了日期范围和时间范围。
UnauthorizedAccessException	调用方没有所要求的权限。
NotSupportedException	path 的格式无效。

备注

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

下表列出了其他典型或相关的 I/O 任务的示例。

若要执行此操作...	请参见本主题中的示例...
写入文本文件。	如何：向文件写入文本
读取文本文件。	如何：从文件读取文本
向文件中追加文本。	如何：打开并追加到日志文件 File.AppendText FileInfo.AppendText
重命名或移动文件。	File.Move FileInfo.MoveTo

.NET Framework 安全性

• FileIOPermission  用于写入到指定的文件。关联的枚举：FileIOPermissionAccess.Write

平台

Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1

请参见

参考

File 类
File 成员
System.IO 命名空间

其他资源

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