File.SetCreationTime Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

Перегрузки

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

SetCreationTime(String, DateTime)

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

File.cs

Устанавливает дату и время создания файла.

public:
 static void SetCreationTime(System::String ^ path, DateTime creationTime);

public static void SetCreationTime (string path, DateTime creationTime);

static member SetCreationTime : string * DateTime -> unit

Public Shared Sub SetCreationTime (path As String, creationTime As DateTime)

Параметры

path

String

Файл, для которого задаются сведения о дате и времени создания.

creationTime

DateTime

Объект DateTime, содержащий значение, которое должно быть задано для даты и времени создания path. Значение представляется в формате местного времени.

Исключения

FileNotFoundException

Указанный путь не найден.

ArgumentException

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

ArgumentNullException

path имеет значение null.

PathTooLongException

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

IOException

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

ArgumentOutOfRangeException

Параметр creationTime указывает значение вне диапазона дат или времени, разрешенного для этой операции.

UnauthorizedAccessException

У вызывающего объекта отсутствует необходимое разрешение.

NotSupportedException

Параметр path задан в недопустимом формате.

Комментарии

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

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

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

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

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

SetCreationTime(SafeFileHandle, DateTime)

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

File.cs

Задает дату и время создания файла или каталога.

public:
 static void SetCreationTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime creationTime);

public static void SetCreationTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime creationTime);

static member SetCreationTime : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit

Public Shared Sub SetCreationTime (fileHandle As SafeFileHandle, creationTime As DateTime)

Параметры

fileHandle

SafeFileHandle

Объект SafeFileHandle для файла или каталога, для которого необходимо задать сведения о дате и времени создания.

creationTime

DateTime

Объект DateTime, содержащий значение, которое должно быть задано для даты и времени создания fileHandle. Значение представляется в формате местного времени.

Исключения

ArgumentNullException

fileHandle имеет значение null.

ArgumentOutOfRangeException

Параметр creationTime указывает значение вне диапазона дат или времени, разрешенного для этой операции.

UnauthorizedAccessException

У вызывающего объекта отсутствует необходимое разрешение.

IOException

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