File.SetCreationTimeUtc Метод

Определение

Перегрузки

SetCreationTimeUtc(SafeFileHandle, DateTime)

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

SetCreationTimeUtc(String, DateTime)

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

SetCreationTimeUtc(SafeFileHandle, DateTime)

Задает дату и время создания файла или каталога в формате 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

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

Исключения

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

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

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

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

Применяется к

SetCreationTimeUtc(String, DateTime)

Задает дату и время создания файла в формате 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

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

Исключения

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

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

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

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

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

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

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

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

Комментарии

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

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

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

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

Применяется к