RandomAccess.WriteAsync Metoda

Reference

Definice

Obor názvů:: System.IO

Sestavení:: System.Runtime.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

ValueTask

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

Výjimky

ArgumentNullException

handle nebo buffers je null.

ArgumentException

Formát handle je neplatný.

ObjectDisposedException

Soubor je zavřený.

NotSupportedException

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

ArgumentOutOfRangeException

fileOffset je negativní.

UnauthorizedAccessException

handle nebyl otevřen pro psaní.

IOException

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

OperationCanceledException

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