File.GetCreationTimeUtc Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestawy:

netstandard.dll, System.Runtime.dll

Przeciążenia

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

GetCreationTimeUtc(SafeFileHandle)

Źródło:

File.cs

Zwraca datę i godzinę utworzenia 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

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

Wyjątki

ArgumentNullException

Parametr fileHandle ma wartość null.

UnauthorizedAccessException

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

GetCreationTimeUtc(String)

Źródło:

File.cs

Zwraca datę i godzinę utworzenia 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

Struktura DateTime 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 ma wymaganych uprawnień.

ArgumentException

Wersje .NET Framework i .NET Core starsze niż 2.1: path to ciąg o zerowej długości, zawiera tylko biały znak lub zawiera jeden lub więcej nieprawidłowych znaków. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars() metody .

ArgumentNullException

Parametr path ma wartość null.

PathTooLongException

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

NotSupportedException

path jest w nieprawidłowym formacie.

Przykłady

W poniższym przykładzie przedstawiono 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

Note

Ta metoda może zwrócić niedokładną wartość, ponieważ używa 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 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 utworzenia pliku, jeśli zastąpisz istniejący plik.

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

Zobacz też

• FileSystemWatcher
• Wejście/Wyjście plików i strumieni
• Odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku