File.GetCreationTime(String) Metod

Definition

Namnområde:
System.IO
Sammansättningar:
mscorlib.dll, System.IO.FileSystem.dll
Sammansättning:
mscorlib.dll
Sammansättning:
System.IO.FileSystem.dll
Sammansättning:
netstandard.dll

Returnerar skapandedatum och tid för den angivna filen eller katalogen.

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

Parametrar

path
String

Den fil eller katalog för vilken du kan hämta information om att skapa datum och tid.

Returer

DateTime

En DateTime struktur som är inställd på skapandedatum och tid för den angivna filen eller katalogen. Det här värdet uttrycks i lokal tid.

Undantag

UnauthorizedAccessException

Anroparen har inte den behörighet som krävs.

ArgumentException

.NET Framework- och .NET Core-versioner som är äldre än 2.1: path är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars() av metoden .

ArgumentNullException

path är null.

PathTooLongException

Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.

NotSupportedException

path är i ett ogiltigt format.

Exempel

I följande exempel visas GetCreationTime.

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

Kommentarer

Note

Den här metoden kan returnera ett felaktigt värde eftersom den använder inbyggda funktioner vars värden kanske inte uppdateras kontinuerligt av operativsystemet.

Parametern path tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen. Information om hur du hämtar den aktuella arbetskatalogen finns i GetCurrentDirectory.

Om filen som beskrivs i parametern path inte finns returnerar den här metoden 12:00 midnatt, 1 januari 1601 E.D. (C.E.) Coordinated Universal Time (UTC), justerad till lokal tid.

NTFS-formaterade enheter kan cachelagrat information om en fil, till exempel tid för att skapa filer, under en kort tidsperiod. Därför kan det vara nödvändigt att uttryckligen ange skapandetiden för en fil om du skriver över eller ersätter en befintlig fil.

En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.

Gäller för

Se även