RandomAccess.FlushToDisk(SafeFileHandle) Method

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Source:

RandomAccess.cs

Flushes the operating system buffers for the given file to disk.

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)

Parameters

handle

SafeFileHandle

The file handle.

Exceptions

ArgumentNullException

handle is null.

ArgumentException

handle is invalid.

ObjectDisposedException

The file is closed.

IOException

An I/O error occurred.

Remarks

This method calls platform-dependent APIs such as FlushFileBuffers() on Windows and fsync() on Unix.

Flushing the buffers causes data to be written to disk, which is a relatively expensive operation. It is recommended that you perform multiple writes to the file and then call this method either when you are done writing to the file or periodically if you expect to continue writing to the file over a long period of time.