File.GetCreationTimeUtc Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
GetCreationTimeUtc(SafeFileHandle)	Vrátí datum a čas vytvoření v koordinovaném univerzálním čase (UTC) zadaného souboru nebo adresáře.
GetCreationTimeUtc(String)	Vrátí datum a čas vytvoření v koordinovaném univerzálním čase (UTC) zadaného souboru nebo adresáře.

GetCreationTimeUtc(SafeFileHandle)

Zdroj:

File.cs

Vrátí datum a čas vytvoření v koordinovaném univerzálním čase (UTC) zadaného souboru nebo adresáře.

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

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 čase UTC.

Výjimky

ArgumentNullException

fileHandle je null.

UnauthorizedAccessException

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

GetCreationTimeUtc(String)

Zdroj:

File.cs

Vrátí datum a čas vytvoření v koordinovaném univerzálním čase (UTC) zadaného souboru nebo adresáře.

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

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 čase UTC.

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

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.

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

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