File.SetCreationTime(String, DateTime) Método

Definição

Define a data e a hora em que o arquivo foi criado.Sets the date and time the file was created.

public:
 static void SetCreationTime(System::String ^ path, DateTime creationTime);
public static void SetCreationTime (string path, DateTime creationTime);
static member SetCreationTime : string * DateTime -> unit
Public Shared Sub SetCreationTime (path As String, creationTime As DateTime)

Parâmetros

path
String

O arquivo para o qual obter as informações de data e hora de criação.The file for which to set the creation date and time information.

creationTime
DateTime

Um DateTime que contém o valor a ser definido para a data de criação e a hora de path.A DateTime containing the value to set for the creation date and time of path. Esse valor é expresso no horário local.This value is expressed in local time.

Exceções

O caminho especificado não foi encontrado.The specified path was not found.

path é uma cadeia de comprimento zero, contém somente espaços em branco ou um ou mais caracteres inválidos, conforme definido por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path é null.path is null.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.The specified path, file name, or both exceed the system-defined maximum length.

Um erro de E/S ocorreu ao realizar a operação.An I/O error occurred while performing the operation.

creationTime especifica um valor fora do intervalo de datas, horas ou ambos permitidos para esta operação.creationTime specifies a value outside the range of dates, times, or both permitted for this operation.

O chamador não tem a permissão necessária.The caller does not have the required permission.

path está em um formato inválido.path is in an invalid format.

Comentários

O path parâmetro tem permissão para especificar informações de caminho relativo ou absoluto.The path parameter is permitted to specify relative or absolute path information. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual.Relative path information is interpreted as relative to the current working directory. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory .To obtain the current working directory, see GetCurrentDirectory.

As unidades formatadas para NTFS podem armazenar em cache as informações de metadados do arquivo, como o tempo de criação do arquivo, por um curto período de tempo.NTFS-formatted drives may cache file meta-info, such as file creation time, for a short period of time. Como resultado, pode ser necessário definir explicitamente a hora de criação de um arquivo se você estiver substituindo ou substituir um arquivo 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 obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Aplica-se a

Confira também