File.GetCreationTime Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Overload

GetCreationTime(SafeFileHandle)	Restituisce l'ora di creazione del file o della directory specificata.
GetCreationTime(String)	Restituisce la data e l'ora di creazione del file o della directory specificata.

GetCreationTime(SafeFileHandle)

Origine:

File.cs

Restituisce l'ora di creazione del file o della directory specificata.

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

Parametri

fileHandle

SafeFileHandle

Oggetto SafeFileHandle nel file o nella 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 locale.

Eccezioni

ArgumentNullException

fileHandle è null.

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

GetCreationTime(String)

Origine:

File.cs

Restituisce la data e l'ora di creazione del file o della directory specificata.

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

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 locale.

Eccezioni

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

ArgumentException

.NET Framework e versioni di .NET Core precedenti a 2.1: path è una stringa di lunghezza zero, contiene solo spazio vuoto 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 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

Commenti

Nota

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

Il path parametro è consentito per specificare informazioni relative o assolute sul percorso. Le informazioni relative sul percorso sono interpretate come relative alla directory di lavoro corrente. Per ottenere la directory di lavoro corrente, vedere GetCurrentDirectory.

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

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

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

Vedi anche

• FileSystemWatcher
• I/O file e flusso
• Lettura del testo da un file
• Procedura: Scrivere un testo in un file