File.GetCreationTimeUtc Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Przeciążenia

GetCreationTimeUtc(SafeFileHandle)	Zwraca datę i godzinę tworzenia w uniwersalnym czasie koordynowanym (UTC) określonego pliku lub katalogu.
GetCreationTimeUtc(String)	Zwraca datę i godzinę tworzenia w uniwersalnym czasie koordynowanym (UTC) określonego pliku lub katalogu.

GetCreationTimeUtc(SafeFileHandle)

Źródło:

File.cs

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

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

A SafeFileHandle do pliku lub katalogu, 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

ArgumentNullException

fileHandle to null.

UnauthorizedAccessException

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

GetCreationTimeUtc(String)

Źródło:

File.cs

Zwraca datę i godzinę tworzenia w uniwersalnym czasie koordynowanym (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.

Zobacz też

• FileSystemWatcher
• Plik i Stream we/wy
• Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku