File.GetCreationTime Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.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

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í.

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 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é

• FileSystemWatcher
• Vstupně-výstupní operace souborů a Stream
• Čtení textu ze souboru
• Postupy: Zápis textu do souboru