Condividi tramite


File.GetCreationTimeUtc Metodo

Definizione

Overload

GetCreationTimeUtc(SafeFileHandle)

Restituisce la data e l'ora di creazione, in utc (Coordinated Universal Time) del file o della directory specificata.

GetCreationTimeUtc(String)

Restituisce la data e l'ora di creazione, in utc (Coordinated Universal Time) del file o della directory specificata.

GetCreationTimeUtc(SafeFileHandle)

Origine:
File.cs
Origine:
File.cs
Origine:
File.cs

Restituisce la data e l'ora di creazione, in utc (Coordinated Universal Time) del file o della directory specificata.

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

Parametri

fileHandle
SafeFileHandle

Oggetto SafeFileHandle al file o alla directory per cui ottenere informazioni sulla data e sull'ora di creazione.

Restituisce

Struttura DateTime impostata sulla data e l'ora di creazione del file o della directory specificata. Questo valore è espresso nell'ora UTC.

Eccezioni

fileHandle è null.

Il chiamante non dispone dell'autorizzazione richiesta.

Si applica a

GetCreationTimeUtc(String)

Origine:
File.cs
Origine:
File.cs
Origine:
File.cs

Restituisce la data e l'ora di creazione, in utc (Coordinated Universal Time) del file o della directory specificata.

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

Parametri

path
String

File o directory per cui ottenere informazioni sulla data e l'ora di creazione.

Restituisce

Struttura DateTime impostata sulla data e l'ora di creazione del file o della directory specificata. Questo valore è espresso nell'ora UTC.

Eccezioni

Il chiamante non dispone dell'autorizzazione richiesta.

.NET Framework e versioni di .NET Core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

path è null.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

Il formato di path non è valido.

Esempio

Nell'esempio seguente viene illustrato il GetCreationTimeUtc metodo.

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

Commenti

Nota

Questo metodo può restituire un valore non accurato, perché usa funzioni native i cui valori potrebbero non essere aggiornati continuamente dal sistema operativo.

Se il file descritto nel path parametro non esiste, questo metodo restituisce 12:00 mezzanotte, 1° gennaio 1601 A.D. (C.E.) Coordinated Universal Time (UTC).

Le unità in formato NTFS possono memorizzare nella cache le informazioni su un file, ad esempio il tempo di creazione di file, per un breve periodo di tempo. Di conseguenza, potrebbe essere necessario impostare in modo esplicito l'ora di creazione di un file se si sovrascrive o si sostituisce un file esistente.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a