File.SetLastWriteTimeUtc Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

SetLastWriteTimeUtc(SafeFileHandle, DateTime)	Define a data e a hora, em UTC (Tempo Universal Coordenado), em que o arquivo ou diretório especificado foi gravado pela última vez.
SetLastWriteTimeUtc(String, DateTime)	Define a data e a hora, em UTC (Tempo Universal Coordenado), em que o arquivo especificado foi gravado pela última vez.

SetLastWriteTimeUtc(SafeFileHandle, DateTime)

Origem:

File.cs

Define a data e a hora, em UTC (Tempo Universal Coordenado), em que o arquivo ou diretório especificado foi gravado pela última vez.

public:
 static void SetLastWriteTimeUtc(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, DateTime lastWriteTimeUtc);

public static void SetLastWriteTimeUtc (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, DateTime lastWriteTimeUtc);

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

Public Shared Sub SetLastWriteTimeUtc (fileHandle As SafeFileHandle, lastWriteTimeUtc As DateTime)

Parâmetros

fileHandle

SafeFileHandle

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

lastWriteTimeUtc

DateTime

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

Exceções

ArgumentNullException

fileHandle é null.

ArgumentOutOfRangeException

lastWriteTimeUtc 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.

SetLastWriteTimeUtc(String, DateTime)

Origem:

File.cs

Define a data e a hora, em UTC (Tempo Universal Coordenado), em que o arquivo especificado foi gravado pela última vez.

public:
 static void SetLastWriteTimeUtc(System::String ^ path, DateTime lastWriteTimeUtc);

public static void SetLastWriteTimeUtc (string path, DateTime lastWriteTimeUtc);

static member SetLastWriteTimeUtc : string * DateTime -> unit

Public Shared Sub SetLastWriteTimeUtc (path As String, lastWriteTimeUtc As DateTime)

Parâmetros

path

String

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

lastWriteTimeUtc

DateTime

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

Exceções

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.

FileNotFoundException

O caminho especificado não foi encontrado.

UnauthorizedAccessException

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

NotSupportedException

path está em um formato inválido.

ArgumentOutOfRangeException

lastWriteTimeUtc especifica um valor fora do intervalo de datas, horas permitido para esta operação.

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.

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

Confira também

• FileSystemWatcher
• E/S de arquivo e de fluxo
• Lendo texto de um arquivo
• Como gravar texto em um arquivo