File.GetCreationTimeUtc(String) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestawy:
mscorlib.dll, System.IO.FileSystem.dll
Zestaw:
System.IO.FileSystem.dll
Zestaw:
System.Runtime.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

Zwraca datę i godzinę utworzenia w skoordynowanym uniwersalnym czasie (UTC) określonego pliku lub katalogu.

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

Plik lub katalog, dla którego można uzyskać informacje o dacie i godzinie utworzenia.

Zwraca

DateTime

DateTime Struktura ustawiona na datę i godzinę utworzenia określonego pliku lub katalogu. Ta wartość jest wyrażona w czasie UTC.

Wyjątki

UnauthorizedAccessException

Obiekt wywołujący nie posiada wymaganych uprawnień.

ArgumentException

.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko biały odstęp lub zawiera co najmniej jeden nieprawidłowy znak. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars() metody .

ArgumentNullException

path to null.

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

NotSupportedException

path jest w nieprawidłowym formacie.

Przykłady

W poniższym przykładzie pokazano metodę 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

Uwagi

Uwaga

Ta metoda może zwracać niedokładną wartość, ponieważ używa ona funkcji natywnych, których wartości mogą nie być stale aktualizowane przez system operacyjny.

Jeśli plik opisany w parametrze path nie istnieje, ta metoda zwraca 12:00 północy, 1 stycznia 1601 R.D. (C.E.) Uniwersalny czas koordynowany (UTC).

Dyski sformatowane przez system NTFS mogą buforowania informacji o pliku, takich jak czas tworzenia pliku, przez krótki czas. W związku z tym może być konieczne jawne ustawienie czasu tworzenia pliku, jeśli zastępujesz lub zastępujesz istniejący plik.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Dotyczy

Zobacz też