Partilhar via


RandomAccess.FlushToDisk(SafeFileHandle) Método

Definição

Libera os buffers do sistema operacional do arquivo fornecido para o disco.

public:
 static void FlushToDisk(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle);
public static void FlushToDisk (Microsoft.Win32.SafeHandles.SafeFileHandle handle);
static member FlushToDisk : Microsoft.Win32.SafeHandles.SafeFileHandle -> unit
Public Shared Sub FlushToDisk (handle As SafeFileHandle)

Parâmetros

handle
SafeFileHandle

O identificador do arquivo.

Exceções

handle é null.

handle é inválido.

O arquivo está fechado.

Ocorreu um erro de E/S.

Comentários

Esse método chama APIs dependentes da plataforma, como FlushFileBuffers() no Windows e fsync() no Unix.

A liberação dos buffers faz com que os dados sejam gravados no disco, o que é uma operação relativamente cara. É recomendável que você execute várias gravações no arquivo e, em seguida, chame esse método quando terminar de gravar no arquivo ou periodicamente se você espera continuar gravando no arquivo por um longo período de tempo.

Aplica-se a