File.SetCreationTimeUtc Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Перегрузки

SetCreationTimeUtc(String, DateTime)	Задает дату и время в формате UTC, созданном файлом.
SetCreationTimeUtc(SafeFileHandle, DateTime)	Задает дату и время в формате UTC, созданное файлом или каталогом.

SetCreationTimeUtc(String, DateTime)

Исходный код:

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

Версии .NET Framework и .NET Core старше 2.1: path представляет собой строку нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().

ArgumentNullException

path null.

PathTooLongException

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

IOException

При выполнении операции произошла ошибка ввода-вывода.

ArgumentOutOfRangeException

creationTimeUtc задает значение вне диапазона дат, времени или обоих разрешенных для этой операции.

UnauthorizedAccessException

Вызывающий объект не имеет требуемого разрешения.

NotSupportedException

path имеет недопустимый формат.

Комментарии

Параметр path может указывать относительные или абсолютные сведения о пути. Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу. Чтобы получить текущий рабочий каталог, см. GetCurrentDirectory.

Диски с форматом NTFS могут кэшировать метаданные файла, такие как время создания файла, в течение короткого периода времени. В результате может потребоваться явно задать время создания файла, если вы перезаписываете или заменяете существующий файл.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• FileSystemWatcher
• файлов и потоковой ввода-вывода
• чтение текста из файла
• Практическое руководство. Запись текста в файл

SetCreationTimeUtc(SafeFileHandle, DateTime)

Исходный код:

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

При выполнении операции произошла ошибка ввода-вывода.