File.GetCreationTime(String) Método

Definición

Espacio de nombres:
System.IO
Ensamblados:
mscorlib.dll, System.IO.FileSystem.dll
Ensamblado:
mscorlib.dll
Ensamblado:
System.IO.FileSystem.dll
Ensamblado:
netstandard.dll

Devuelve la fecha y hora de creación del archivo o 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 establecida en la fecha y hora de creación del archivo o directorio especificados. Este valor se expresa en la hora local.

Excepciones

UnauthorizedAccessException

El autor de la llamada no tiene el permiso necesario.

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a la 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 caracteres no válidos mediante 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 tiene 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

Note

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 el tiempo de creación de un archivo si está sobrescribir o reemplazar un archivo existente.

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

Se aplica a

Consulte también