File.GetCreationTime Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
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

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

Do SafeFileHandle 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 se vyjadřuje v místním čase.

Výjimky

ArgumentNullException

fileHandle je null.

UnauthorizedAccessException

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

GetCreationTime(String)

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 se vyjadřuje 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 můžete zadat dotaz 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

Note

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á povoleno zadat relativní nebo absolutní informace o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři. Aktuální pracovní adresář získáte v tématu GetCurrentDirectory.

Pokud soubor popsaný v parametru path neexistuje, vrátí tato metoda 12:00 půlnoc, 1. ledna 1601 A.D. (C.E.) Koordinovaný univerzální čas (UTC) upravený na místní čas.

Jednotky formátované systémem NTFS můžou po krátkou dobu ukládat informace o souboru, jako je například čas vytvoření souboru. V důsledku toho může být nutné explicitně nastavit čas vytvoření souboru, pokud přepíšete nebo nahradíte existující soubor.

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

Viz také

• FileSystemWatcher
• Vstup/výstup souborů a streamů
• Čtení textu ze souboru
• Postupy: Zápis textu do souboru