RandomAccess.WriteAsync Metoda

Definicja

Przestrzeń nazw:: System.IO

Zestaw:: System.Runtime.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

Nazwisko	Opis
WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)	Zapisuje sekwencję bajtów z podanych buforów do danego pliku z danym przesunięciem.
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)	Zapisuje sekwencję bajtów z danego buforu do danego pliku z danym przesunięciem.

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

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Zapisuje sekwencję bajtów z podanych buforów do danego pliku z danym przesunięciem.

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

Dojście do pliku.

buffers: IReadOnlyList<ReadOnlyMemory<Byte>>

Lista buforów pamięci. Ta metoda kopiuje zawartość tych buforów do pliku.

fileOffset: Int64

Pozycja pliku do zapisu. W .NET 11 lub nowszych wersjach ten parametr jest ignorowany dla plików, które nie obsługują wyszukiwania, takich jak potoki, gniazda i urządzenia znakowe. Wartość musi być nieujemna nawet wtedy, gdy jest ignorowana.

cancellationToken: CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

ValueTask

Zadanie reprezentujące asynchroniczne ukończenie operacji zapisu.

Wyjątki

ArgumentNullException

handle lub buffers ma wartość null.

ArgumentException

handle jest nieprawidłowy.

ObjectDisposedException

Plik jest zamknięty.

NotSupportedException

W .NET 10 i starszych wersjach plik nie obsługuje wyszukiwania (na przykład potoku lub gniazda).

ArgumentOutOfRangeException

fileOffset jest ujemna.

UnauthorizedAccessException

handle nie został otwarty do pisania.

IOException

Wystąpił błąd we/wy.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

W przypadku plików, które obsługują wyszukiwanie, pozycja pliku nie jest zaawansowana.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).

Dotyczy

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

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Źródło:: RandomAccess.cs

Zapisuje sekwencję bajtów z danego buforu do danego pliku z danym przesunięciem.

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