File.GetCreationTime Метод

Определение

Пространство имен:
System.IO
Сборки:
netstandard.dll, System.Runtime.dll
Сборки:
mscorlib.dll, System.IO.FileSystem.dll
Сборки:
netstandard.dll, System.IO.FileSystem.dll
Сборки:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Сборка:
System.IO.FileSystem.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

Перегрузки

Имя Описание
GetCreationTime(SafeFileHandle)

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

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

GetCreationTime(SafeFileHandle)

Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
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
Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
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

Комментарии

Note

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

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

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

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

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

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

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