RandomAccess.FlushToDisk(SafeFileHandle) Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

RandomAccess.cs

Vyprázdní vyrovnávací paměti operačního systému pro daný soubor na 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)

Parametry

handle

SafeFileHandle

Popisovač souboru.

Výjimky

ArgumentNullException

handle je null.

ArgumentException

Formát handle je neplatný.

ObjectDisposedException

Soubor je zavřený.

IOException

Došlo k vstupně-výstupní chybě.

Poznámky

Tato metoda volá rozhraní API závislá na platformě, například FlushFileBuffers() v systémech Windows a fsync() Unix.

Vyprázdnění vyrovnávacích pamětí způsobí zápis dat na disk, což je poměrně nákladná operace. Doporučuje se provést více zápisů do souboru a volat tuto metodu buď po dokončení zápisu do souboru, nebo pravidelně, pokud očekáváte, že budete pokračovat v zápisu do souboru po dlouhou dobu.