File.GetCreationTime Metoda

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll, System.IO.FileSystem.dll
Sestavení:
System.IO.FileSystem.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Přetížení

GetCreationTime(SafeFileHandle)

Vrátí čas vytvoření zadaného souboru nebo adresáře.
GetCreationTime(String)

Vrátí datum a čas vytvoření zadaného souboru nebo adresáře.

GetCreationTime(SafeFileHandle)

Zdroj:
File.cs
Zdroj:
File.cs
Zdroj:
File.cs

Vrátí čas vytvoření zadaného souboru nebo adresáře.

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

Parametry

fileHandle
SafeFileHandle

A SafeFileHandle do souboru nebo adresáře, pro který chcete získat informace o datu a čase vytvoření.

Návraty

DateTime

Struktura nastavená DateTime na datum a čas vytvoření zadaného souboru nebo adresáře. Tato hodnota je vyjádřena v místním čase.

Výjimky

ArgumentNullException

fileHandle je null.

UnauthorizedAccessException

Volající nemá požadované oprávnění.

Platí pro

GetCreationTime(String)

Zdroj:
File.cs
Zdroj:
File.cs
Zdroj:
File.cs

Vrátí datum a čas vytvoření zadaného souboru nebo adresáře.

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

Parametry

path
String

Soubor nebo adresář, pro který chcete získat informace o datu a čase vytvoření.

Návraty

DateTime

Struktura nastavená DateTime na datum a čas vytvoření zadaného souboru nebo adresáře. Tato hodnota je vyjádřena v místním čase.

Výjimky

UnauthorizedAccessException

Volající nemá požadované oprávnění.

ArgumentException

Verze .NET Framework a .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Pomocí metody se můžete dotazovat na neplatné znaky GetInvalidPathChars() .

ArgumentNullException

path je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

NotSupportedException

path je v neplatném formátu.

Příklady

Následující příklad ukazuje 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

Poznámky

Poznámka

Tato metoda může vrátit nepřesnou hodnotu, protože používá nativní funkce, jejichž hodnoty nemusí být průběžně aktualizovány operačním systémem.

Parametr path může zadat informace o relativní nebo absolutní cestě. Informace o relativní cestě jsou vykládány jako relativní k aktuálnímu pracovnímu adresáři. Informace o získání aktuálního pracovního adresáře najdete v tématu GetCurrentDirectory.

Pokud soubor popsaný v parametru path neexistuje, vrátí tato metoda 12:00 půlnoc 1. ledna 1601 n. Koordinovaný světový čas (UTC) upravený na místní čas.

Jednotky ve formátu NTFS mohou po krátkou dobu ukládat informace o souboru do mezipaměti, například čas vytvoření souboru. V důsledku toho může být nutné explicitně nastavit čas vytvoření souboru, pokud přepisujete nebo nahrazujete existující soubor.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro