File.GetCreationTimeUtc Метод

Определение

Перегрузки

GetCreationTimeUtc(SafeFileHandle)

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

GetCreationTimeUtc(String)

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

GetCreationTimeUtc(SafeFileHandle)

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

public:
 static DateTime GetCreationTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);
public static DateTime GetCreationTimeUtc (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);
static member GetCreationTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime
Public Shared Function GetCreationTimeUtc (fileHandle As SafeFileHandle) As DateTime

Параметры

fileHandle
SafeFileHandle

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

Возвращаемое значение

Структура DateTime, для которой заданы дата и время создания указанного файла или каталога. Значение выражено в формате всемирного координированного времени (UTC).

Исключения

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

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

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

GetCreationTimeUtc(String)

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

public:
 static DateTime GetCreationTimeUtc(System::String ^ path);
public static DateTime GetCreationTimeUtc (string path);
static member GetCreationTimeUtc : string -> DateTime
Public Shared Function GetCreationTimeUtc (path As String) As DateTime

Параметры

path
String

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

Возвращаемое значение

Структура DateTime, для которой заданы дата и время создания указанного файла или каталога. Значение выражено в формате всемирного координированного времени (UTC).

Исключения

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

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

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

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

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

Примеры

В следующем примере демонстрируется GetCreationTimeUtc метод.

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

Комментарии

Примечание

Этот метод может возвращать неточное значение, так как использует собственные функции, значения которых не могут постоянно обновляться операционной системой.

Если файл, описанный в параметре path , не существует, этот метод возвращает 12:00 полуночи 1 января 1601 г. н.э. Время в формате UTC.

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

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

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

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