File.SetCreationTime Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

SetCreationTime(SafeFileHandle, DateTime)	Define a data e a hora em que o arquivo ou diretório foi criado.
SetCreationTime(String, DateTime)	Define a data e a hora em que o arquivo foi criado.

SetCreationTime(SafeFileHandle, DateTime)

Origem:

File.cs

Define a data e a hora em que o arquivo ou diretório foi criado.

public:
 static void SetCreationTime(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime creationTime);

public static void SetCreationTime (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime creationTime);

static member SetCreationTime : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit

Public Shared Sub SetCreationTime (fileHandle As SafeFileHandle, creationTime As DateTime)

Parâmetros

fileHandle

SafeFileHandle

Um SafeFileHandle para o arquivo ou diretório para o qual definir as informações de data e hora de criação.

creationTime

DateTime

Um DateTime que contém o valor a ser definido para a data e hora de criação de fileHandle. Esse valor é expresso no horário local.

Exceções

ArgumentNullException

fileHandle é null.

ArgumentOutOfRangeException

creationTime especifica um valor fora do intervalo de datas, horas ou ambos permitidos para essa operação.

UnauthorizedAccessException

O chamador não tem a permissão necessária.

IOException

Ocorreu um erro de E/S ao executar a operação.

SetCreationTime(String, DateTime)

Origem:

File.cs

Define a data e a hora em que o arquivo foi criado.

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 definir as informações de data e hora de criação.

creationTime

DateTime

Um DateTime que contém o valor a ser definido para a data e hora de criação de path. Esse valor é expresso no horário local.

Exceções

FileNotFoundException

O caminho especificado não foi encontrado.

ArgumentException

Versões do .NET Framework e do .NET Core anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos. Você pode consultar caracteres inválidos usando o método GetInvalidPathChars().

ArgumentNullException

path é null.

PathTooLongException

O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.

IOException

Ocorreu um erro de E/S ao executar a operação.

ArgumentOutOfRangeException

creationTime especifica um valor fora do intervalo de datas, horas ou ambos permitidos para essa operação.

UnauthorizedAccessException

O chamador não tem a permissão necessária.

NotSupportedException

path está em um formato inválido.

Comentários

O parâmetro path tem permissão para especificar informações de caminho relativas ou absolutas. As informações de caminho relativo são interpretadas como relativas ao diretório de trabalho atual. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory.

As unidades formatadas em NTFS podem armazenar em cache meta-informações de arquivo, como o tempo de criação do arquivo, por um curto período de tempo. Como resultado, talvez seja necessário definir explicitamente o tempo de criação de um arquivo se você estiver substituindo ou substituindo um arquivo existente.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

• FileSystemWatcher
• de E/S de Fluxo e Arquivo
• leitura de texto de uma de arquivo
• Como gravar texto em um arquivo