RandomAccess.FlushToDisk(SafeFileHandle) 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

RandomAccess.cs

將指定檔案的作業系統緩衝區排清到磁碟。

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)

參數

handle

SafeFileHandle

檔句柄。

例外狀況

ArgumentNullException

handle 為 null。

ArgumentException

handle 無效。

ObjectDisposedException

檔案已關閉。

IOException

發生 I/O 錯誤。

備註

這個方法會呼叫平臺相依 API，例如 FlushFileBuffers() 在 Windows 和 fsync() Unix 上。

清除緩衝區會導致數據寫入磁碟，這是相對昂貴的作業。 建議您對檔案執行多個寫入，然後在您完成寫入檔案時呼叫這個方法，或者如果您預期會持續寫入檔案一段時間，請定期呼叫此方法。