File.GetCreationTime(String) Método

Definición

Devuelve la fecha y hora de creación del archivo o el directorio especificados.Returns the creation date and time of the specified file or directory.

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.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 local.This value is expressed in local 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.

path es null.path is null.

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 ejemplo siguiente se muestra GetCreationTime.The following example demonstrates 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, 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.

El parámetro path puede especificar información de ruta de acceso relativa o absoluta.The path parameter is permitted to specify relative or absolute path information. La información de la ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual.Relative path information is interpreted as relative to the current working directory. Para obtener el directorio de trabajo actual, vea GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Si el archivo descrito en el parámetro path 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. (E. C.). Hora universal coordinada (UTC), ajustado a la hora local.(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

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: