File.GetCreationTimeUtc Метод

Определение

Пространство имен:
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

Перегрузки

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

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

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

GetCreationTimeUtc(SafeFileHandle)

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

Комментарии

Note

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

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

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

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

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

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