Directory.SetCreationTimeUtc(String, DateTime) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Sets the creation date and time, in Coordinated Universal Time (UTC) format, for the specified file or directory.
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)
Parameters
- path
- String
The file or directory for which to set the creation date and time information.
- creationTimeUtc
- DateTime
The date and time the directory or file was created. This value is expressed in local time.
Exceptions
The specified path was not found.
.NET Framework and .NET Core versions older than 2.1: path
is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters with the GetInvalidPathChars() method.
path
is null
.
The specified path, file name, or both exceed the system-defined maximum length.
The caller does not have the required permission.
creationTime
specifies a value outside the range of dates or times permitted for this operation.
The current operating system is not Windows NT or later.
Remarks
The path
parameter is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory. To obtain the current working directory, see GetCurrentDirectory.
The case-sensitivity of the path
parameter corresponds to that of the file system on which the code is running. For example, it's case-insensitive on NTFS (the default Windows file system) and case-sensitive on Linux file systems.
For a list of common I/O tasks, see Common I/O Tasks.