File::GetCreationTimeUtc Method (String^)
Returns the creation date and time, in coordinated universal time (UTC), of the specified file or directory.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- path
-
Type:
System::String^
The file or directory for which to obtain creation date and time information.
Return Value
Type: System::DateTimeA DateTime structure set to the creation date and time for the specified file or directory. This value is expressed in UTC time.
| Exception | Condition |
|---|---|
| UnauthorizedAccessException | The caller does not have the required permission. |
| ArgumentException | path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars. |
| ArgumentNullException | path is null. |
| PathTooLongException | The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. |
| NotSupportedException | path is in an invalid format. |
Note |
|---|
This method may return an inaccurate value, because it uses native functions whose values may not be continuously updated by the operating system. |
If the file described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC).
NTFS-formatted drives may cache information about a file, such as file creation time, for a short period of time. As a result, it may be necessary to explicitly set the creation time of a file if you are overwriting or replacing an existing file.
For a list of common I/O tasks, see Common I-O Tasks.
The following example demonstrates the GetCreationTimeUtc method.
Imports System.IO Module Module1 Sub Main() Dim fileCreatedDate As DateTime = File.GetCreationTimeUtc("C:\Example\MyTest.txt") Console.WriteLine("file created: " + fileCreatedDate) End Sub End Module
for reading from the specified file. Associated enumeration: FileIOPermissionAccess::Read
Available since 10
.NET Framework
Available since 1.1
