RandomAccess.FlushToDisk(SafeFileHandle) Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

RandomAccess.cs

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

ArgumentNullException

handle é null.

ArgumentException

handle é inválido.

ObjectDisposedException

O arquivo está fechado.

IOException

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.