File.GetCreationTime Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

Перегрузки

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

GetCreationTime(SafeFileHandle)

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

File.cs

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

public:
 static DateTime GetCreationTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static DateTime GetCreationTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetCreationTime : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime

Public Shared Function GetCreationTime (fileHandle As SafeFileHandle) As DateTime

Параметры

fileHandle

SafeFileHandle

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

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

DateTime

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

Исключения

ArgumentNullException

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

UnauthorizedAccessException

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

GetCreationTime(String)

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

File.cs

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

public:
 static DateTime GetCreationTime(System::String ^ path);

public static DateTime GetCreationTime (string path);

static member GetCreationTime : string -> DateTime

Public Shared Function GetCreationTime (path As String) As DateTime

Параметры

path

String

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

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

DateTime

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

Исключения

UnauthorizedAccessException

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

ArgumentException

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

ArgumentNullException

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

PathTooLongException

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

NotSupportedException

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

Примеры

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

Imports System.IO

Module Module1

    Sub Main()
        Dim fileCreatedDate As DateTime = File.GetCreationTime("C:\Example\MyTest.txt")
        Console.WriteLine("file created: " + fileCreatedDate)
    End Sub

End Module

Комментарии

Примечание

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

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

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

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

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

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

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