File.GetCreationTimeUtc Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

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

GetCreationTimeUtc(SafeFileHandle)

Zdroj:

File.cs

Vrátí datum a čas vytvoření zadaného souboru nebo adresáře v koordinovaném univerzálním čase (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

Parametry

fileHandle

SafeFileHandle

Soubor SafeFileHandle 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 č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í zadaného souboru nebo adresáře v koordinovaném univerzálním čase (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

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

Výjimky

UnauthorizedAccessException

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

ArgumentException

.NET Framework a .NET Core verze 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ů. Na neplatné znaky se můžete dotazovat pomocí metody .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

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.

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

Jednotky formátované systémem souborů 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ř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
• Vstupně-výstupní operace souborů a Stream
• Čtení textu ze souboru
• Postupy: Zápis textu do souboru