File.GetCreationTimeUtc(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 i Coordinated Universal Time (UTC) för den angivna filen eller katalogen.

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

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 UTC-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 GetCreationTimeUtc metoden.

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

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.

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

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