File.GetCreationTimeUtc(String) File.GetCreationTimeUtc(String) File.GetCreationTimeUtc(String) File.GetCreationTimeUtc(String) Method

Definición

Devuelve la fecha y la hora de creación, en formato de hora universal coordinada (UTC), del archivo o directorio especificado.Returns the creation date and time, in coordinated universal time (UTC), of the specified file or directory.

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 String String String

Archivo o directorio para el que se va a obtener información de fecha y hora de creación.The file or directory for which to obtain creation date and time information.

Devoluciones

Estructura DateTime que se establece en la fecha y hora de creación para el archivo o directorio especificado.A DateTime structure set to the creation date and time for the specified file or directory. Este valor se expresa en hora UTC.This value is expressed in UTC time.

Excepciones

El llamador no dispone del permiso requerido.The caller does not have the required permission.

path es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

path está en un formato no válido.path is in an invalid format.

Ejemplos

En el siguiente ejemplo se GetCreationTimeUtc muestra el método.The following example demonstrates the GetCreationTimeUtc method.

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, porque usa funciones nativas cuyos valores no se pueden actualizar continuamente mediante el sistema operativo.This method may return an inaccurate value, because it uses native functions whose values may not be continuously updated by the operating system.

Si el archivo descrito en el path parámetro no existe, este método devuelve 12:00 de la medianoche del 1 de enero de 1601 d.c.If the file described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Hora universal coordinada (UTC).(C.E.) Coordinated Universal Time (UTC).

Las unidades con formato NTFS pueden almacenar en caché información sobre un archivo, como el tiempo de creación de un archivo, durante un breve período de tiempo.NTFS-formatted drives may cache information about a file, such as file creation time, for a short period of time. Como resultado, puede ser necesario establecer explícitamente la hora de creación de un archivo si va a sobrescribir o reemplazar un archivo existente.As a result, it may be necessary to explicitly set the creation time of a file if you are overwriting or replacing an existing file.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Seguridad

FileIOPermission
para leer desde el archivo especificado.for reading from the specified file. Enumeración asociada:ReadAssociated enumeration: Read

Se aplica a

Consulte también: