File.SetCreationTime Método

Definição

Espaço de Nomes:
System.IO
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagens:
mscorlib.dll, System.IO.FileSystem.dll
Assemblagens:
netstandard.dll, System.IO.FileSystem.dll
Assemblagens:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Assemblagem:
System.IO.FileSystem.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Sobrecargas

Name Description
SetCreationTime(SafeFileHandle, DateTime)

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

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

SetCreationTime(SafeFileHandle, DateTime)

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

Define a data e hora em que o ficheiro 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

A SafeFileHandle para o ficheiro ou diretório para o qual definir a data e a hora de criação.

creationTime
DateTime

A contendo DateTime o valor a definir para a data e hora de criação de fileHandle. Este valor é expresso em tempo local.

Exceções

ArgumentNullException

fileHandle é null.

ArgumentOutOfRangeException

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

UnauthorizedAccessException

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

IOException

Ocorreu um erro de I/O durante a execução da operação.

Aplica-se a

SetCreationTime(String, DateTime)

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

Define a data e hora em que o ficheiro 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 ficheiro para o qual definir a data e hora da criação.

creationTime
DateTime

A contendo DateTime o valor a definir para a data e hora de criação de path. Este valor é expresso em tempo local.

Exceções

FileNotFoundException

O caminho especificado não foi encontrado.

ArgumentException

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

ArgumentNullException

path é null.

PathTooLongException

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

IOException

Ocorreu um erro de I/O durante a execução da operação.

ArgumentOutOfRangeException

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

UnauthorizedAccessException

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

NotSupportedException

path está num formato inválido.

Observações

O path parâmetro pode especificar informação relativa ou absoluta do caminho. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual. Para obter o diretório de trabalho atual, veja GetCurrentDirectory.

Discos formatados em NTFS podem armazenar em cache meta-informação de ficheiros, como o tempo de criação do ficheiro, por um curto período de tempo. Como resultado, pode ser necessário definir explicitamente o tempo de criação de um ficheiro se estiver a sobrescrever ou substituir um ficheiro existente.

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

Ver também

Aplica-se a