File.GetCreationTimeUtc Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

Перегрузки

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

GetCreationTimeUtc(SafeFileHandle)

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

File.cs

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

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

Исключения

ArgumentNullException

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

UnauthorizedAccessException

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

GetCreationTimeUtc(String)

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

File.cs

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

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

Исключения

UnauthorizedAccessException

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

ArgumentException

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

ArgumentNullException

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

PathTooLongException

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

NotSupportedException

Параметр 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 могут кэшировать сведения о файле, например время создания файла, в течение короткого периода времени. В результате может потребоваться явно задать время создания файла, если вы перезаписываете или заменяете существующий файл.

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

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

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