File.GetCreationTime Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Sobrecargas

GetCreationTime(SafeFileHandle)	Devuelve la hora de creación del archivo o directorio especificados.
GetCreationTime(String)	Devuelve la fecha y hora de creación del archivo o el directorio especificados.

GetCreationTime(SafeFileHandle)

Source:

File.cs

Devuelve la hora de creación del archivo o directorio especificados.

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

Parámetros

fileHandle

SafeFileHandle

objeto SafeFileHandle al archivo o directorio para el que se va a obtener información de fecha y hora de creación.

Devoluciones

DateTime

Estructura DateTime que se establece en la fecha y hora de creación para el archivo o directorio especificado. Este valor se expresa en hora local.

Excepciones

ArgumentNullException

fileHandle es null.

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

GetCreationTime(String)

Source:

File.cs

Devuelve la fecha y hora de creación del archivo o el directorio especificados.

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

Parámetros

path

String

Archivo o directorio para el que se va a obtener información de fecha y hora de creación.

Devoluciones

DateTime

Estructura DateTime que se establece en la fecha y hora de creación para el archivo o directorio especificado. Este valor se expresa en hora local.

Excepciones

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene uno o varios caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars().

ArgumentNullException

path es null.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

NotSupportedException

path está en un formato no válido.

Ejemplos

En el ejemplo siguiente se muestra 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

Comentarios

Nota

Este método puede devolver un valor inexacto, ya que usa funciones nativas cuyos valores pueden no actualizarse continuamente por el sistema operativo.

El path parámetro puede especificar información de ruta de acceso relativa o absoluta. La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual. Para obtener el directorio de trabajo actual, consulte GetCurrentDirectory.

Si el archivo descrito en el path parámetro no existe, este método devuelve 12:00 medianoche, 1 de enero de 1601 A.D. (C.E.) Hora universal coordinada (UTC), ajustada a la hora local.

Las unidades con formato NTFS pueden almacenar en caché información sobre un archivo, como el tiempo de creación de archivos, durante un breve período de tiempo. Como resultado, puede ser necesario establecer explícitamente la hora de creación de un archivo si se sobrescribe o se reemplaza un archivo existente.

Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.

Consulte también

• FileSystemWatcher
• E/S de archivos y secuencias
• Leer texto de un archivo
• Cómo: Escribir texto en un archivo