File.GetCreationTimeUtc Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

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

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

DateTime

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

Eccezioni

ArgumentNullException

fileHandle è null.

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

GetCreationTimeUtc(String)

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

DateTime

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

Eccezioni

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

ArgumentException

.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().

ArgumentNullException

path è null.

PathTooLongException

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

NotSupportedException

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

• FileSystemWatcher
• I/O di file e Stream
• Lettura di testo da un file
• Procedura: Scrivere un testo in un file