Sdílet prostřednictvím


RandomAccess.WriteAsync Metoda

Definice

Přetížení

WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)

Zapíše posloupnost bajtů z daných vyrovnávacích pamětí do daného souboru při daném posunu.

WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)

Zapíše posloupnost bajtů z dané vyrovnávací paměti do daného souboru při daném posunu.

WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)

Zdroj:
RandomAccess.cs
Zdroj:
RandomAccess.cs
Zdroj:
RandomAccess.cs

Zapíše posloupnost bajtů z daných vyrovnávacích pamětí do daného souboru při daném posunu.

public static System.Threading.Tasks.ValueTask WriteAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);
static member WriteAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Shared Function WriteAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of ReadOnlyMemory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametry

handle
SafeFileHandle

Popisovač souboru.

buffers
IReadOnlyList<ReadOnlyMemory<Byte>>

Seznam vyrovnávacích pamětí. Tato metoda zkopíruje obsah těchto vyrovnávacích pamětí do souboru.

fileOffset
Int64

Umístění souboru, do které se má zapisovat.

cancellationToken
CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Úloha představující asynchronní dokončení operace zápisu.

Výjimky

handle nebo buffers je null.

Formát handle je neplatný.

Soubor je zavřený.

Soubor nepodporuje vyhledávání (potrubí nebo soket).

fileOffset je negativní.

handle nebyl otevřen pro psaní.

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

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Umístění souboru není upřesňující.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).

Platí pro

WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)

Zdroj:
RandomAccess.cs
Zdroj:
RandomAccess.cs
Zdroj:
RandomAccess.cs

Zapíše posloupnost bajtů z dané vyrovnávací paměti do daného souboru při daném posunu.

public static System.Threading.Tasks.ValueTask WriteAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, ReadOnlyMemory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);
static member WriteAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * ReadOnlyMemory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Shared Function WriteAsync (handle As SafeFileHandle, buffer As ReadOnlyMemory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametry

handle
SafeFileHandle

Popisovač souboru.

buffer
ReadOnlyMemory<Byte>

Oblast paměti. Tato metoda zkopíruje obsah této oblasti do souboru.

fileOffset
Int64

Umístění souboru, do které se má zapisovat.

cancellationToken
CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Úloha představující asynchronní dokončení operace zápisu.

Výjimky

handle je null.

Formát handle je neplatný.

Soubor je zavřený.

Soubor nepodporuje vyhledávání (potrubí nebo soket).

fileOffset je negativní.

handle nebyl otevřen pro psaní.

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

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Umístění souboru není upřesňující.

Platí pro