File.SetCreationTimeUtc Método

  • Referência

Definição

Namespace:
System.IO
Assembly:
System.Runtime.dll
Assemblies:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Sobrecargas

SetCreationTimeUtc(SafeFileHandle, DateTime)

Define a data e a hora, em UTC (Tempo Universal Coordenado), que o arquivo ou diretório foi criado.
SetCreationTimeUtc(String, DateTime)

Define a data e a hora, em UTC (Tempo Universal Coordenado), que o arquivo foi criado.

SetCreationTimeUtc(SafeFileHandle, DateTime)

Origem:
File.cs
Origem:
File.cs
Origem:
File.cs

Define a data e a hora, em UTC (Tempo Universal Coordenado), que o arquivo ou diretório foi criado.

public:
 static void SetCreationTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime creationTimeUtc);
public static void SetCreationTimeUtc (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime creationTimeUtc);
static member SetCreationTimeUtc : Microsoft.Win32.SafeHandles.SafeFileHandle * DateTime -> unit
Public Shared Sub SetCreationTimeUtc (fileHandle As SafeFileHandle, creationTimeUtc 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.

creationTimeUtc
DateTime

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

Exceções

ArgumentNullException

fileHandle é null.

ArgumentOutOfRangeException

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

UnauthorizedAccessException

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

IOException

Um erro de E/S ocorreu ao realizar a operação.

Aplica-se a

SetCreationTimeUtc(String, DateTime)

Origem:
File.cs
Origem:
File.cs
Origem:
File.cs

Define a data e a hora, em UTC (Tempo Universal Coordenado), que o arquivo foi criado.

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

Parâmetros

path
String

O arquivo para o qual obter as informações de data e hora de criação.

creationTimeUtc
DateTime

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

Exceções

FileNotFoundException

O caminho especificado não foi encontrado.

ArgumentException

.NET Framework e versões 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. Consulte caracteres inválidos usando o método GetInvalidPathChars().

ArgumentNullException

path é null.

PathTooLongException

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

IOException

Um erro de E/S ocorreu ao realizar a operação.

ArgumentOutOfRangeException

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

UnauthorizedAccessException

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

NotSupportedException

path está em um formato inválido.

Comentários

O path parâmetro tem permissão para especificar informações de caminho relativas ou absolutas. As informações do 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 as meta-informações do arquivo, como o tempo de criação do arquivo, por um curto período de tempo. Como resultado, pode ser necessário definir explicitamente a hora 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

Aplica-se a