File.SetCreationTimeUtc(String, DateTime) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 definir as informações de data e hora de criação.
- creationTimeUtc
- DateTime
O valor a ser definido para a data e hora de criação de path. Esse valor é expresso em tempo UTC.
Exceções
O caminho especificado não foi encontrado.
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 GetInvalidPathChars() método.
path é null.
O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.
Ocorreu um erro de E/S ao executar a operação.
creationTimeUtc especifica um valor fora do intervalo de datas, horas ou ambos permitidos para essa operação.
O chamador não tem a permissão necessária.
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 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.