File.GetCreationTime Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Przeciążenia

GetCreationTime(SafeFileHandle)	Zwraca czas utworzenia określonego pliku lub katalogu.
GetCreationTime(String)	Zwraca datę i godzinę utworzenia określonego pliku lub katalogu.

GetCreationTime(SafeFileHandle)

Źródło:

File.cs

Zwraca czas utworzenia określonego pliku lub katalogu.

public:
 static DateTime GetCreationTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static DateTime GetCreationTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetCreationTime : Microsoft.Win32.SafeHandles.SafeFileHandle -> DateTime

Public Shared Function GetCreationTime (fileHandle As SafeFileHandle) As DateTime

Parametry

fileHandle

SafeFileHandle

Do SafeFileHandle pliku lub katalogu, dla którego należy 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 lokalnym.

Wyjątki

ArgumentNullException

fileHandle to null.

UnauthorizedAccessException

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

GetCreationTime(String)

Źródło:

File.cs

Zwraca datę i godzinę utworzenia określonego pliku lub katalogu.

public:
 static DateTime GetCreationTime(System::String ^ path);

public static DateTime GetCreationTime (string path);

static member GetCreationTime : string -> DateTime

Public Shared Function GetCreationTime (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 lokalnym.

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 znak lub zawiera co najmniej jeden nieprawidłowy znak. Zapytania dotyczące nieprawidłowych znaków można wykonać 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 GetCreationTimeelement .

Imports System.IO

Module Module1

    Sub Main()
        Dim fileCreatedDate As DateTime = File.GetCreationTime("C:\Example\MyTest.txt")
        Console.WriteLine("file created: " + fileCreatedDate)
    End Sub

End Module

Uwagi

Uwaga

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.

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względne w stosunku do bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

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

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ępujesz lub zastępujesz istniejący plik.

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

Zobacz też

• FileSystemWatcher
• We/wy plików i Stream
• Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku