File.GetCreationTimeUtc Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Sobrecargas

GetCreationTimeUtc(SafeFileHandle)	Devuelve la fecha y hora de creación, en hora universal coordinada (UTC), del archivo o directorio especificados.
GetCreationTimeUtc(String)	Devuelve la fecha y hora de creación, en hora universal coordinada (UTC), del archivo o directorio especificados.

GetCreationTimeUtc(SafeFileHandle)

Source:

File.cs

Devuelve la fecha y hora de creación, en hora universal coordinada (UTC), del archivo o directorio especificados.

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

Parámetros

fileHandle

SafeFileHandle

al SafeFileHandle 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 UTC.

Excepciones

ArgumentNullException

fileHandle es null.

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

GetCreationTimeUtc(String)

Source:

File.cs

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 que se establece en la fecha y hora de creación para el archivo o directorio especificado. Este valor se expresa en hora UTC.

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, contiene solo 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 siguiente ejemplo 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

Nota

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 la hora de creación de un archivo si está sobrescribiendo o reemplazando un archivo existente.

Para obtener una lista de las 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