File.GetCreationTimeUtc Metodo

Definizione

Spazio dei nomi:
System.IO
Assembly:
netstandard.dll, System.Runtime.dll
Assembly:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
netstandard.dll, System.IO.FileSystem.dll
Assembly:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Overload

Nome Descrizione
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
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 per il file o la directory per cui ottenere informazioni sulla data e l'ora di creazione.

Valori restituiti

DateTime

Struttura DateTime impostata sulla data e l'ora di creazione per il file o la directory specificati. Questo valore è espresso nell'ora UTC.

Eccezioni

ArgumentNullException

fileHandle è null.

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

Si applica a

GetCreationTimeUtc(String)

Origine:
File.cs
Origine:
File.cs
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.

Valori restituiti

DateTime

Struttura DateTime impostata sulla data e l'ora di creazione per il file o la directory specificati. 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 eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().

ArgumentNullException

path è null.

PathTooLongException

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

NotSupportedException

path è in un formato 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

Note

Questo metodo può restituire un valore impreciso, 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.) Ora UTC (Coordinated Universal Time).

Le unità in formato NTFS possono memorizzare nella cache 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