File.GetCreationTimeUtc(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, en Hora universal coordinada (UTC), del archivo o directorio especificados.

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

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 hora UTC.

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 el GetCreationTimeUtc método .

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

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.

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

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