Bagikan melalui


RandomAccess.WriteAsync Metode

Definisi

Overload

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

Menulis urutan byte dari buffer yang diberikan ke file yang diberikan pada offset yang diberikan.

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

Menulis urutan byte dari buffer yang diberikan ke file yang diberikan pada offset yang diberikan.

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

Sumber:
RandomAccess.cs
Sumber:
RandomAccess.cs
Sumber:
RandomAccess.cs

Menulis urutan byte dari buffer yang diberikan ke file yang diberikan pada offset yang diberikan.

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

Parameter

handle
SafeFileHandle

Handel file.

buffers
IReadOnlyList<ReadOnlyMemory<Byte>>

Daftar buffer memori. Metode ini menyalin isi buffer ini ke file.

fileOffset
Int64

Posisi file untuk ditulis.

cancellationToken
CancellationToken

Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.

Mengembalikan

Tugas yang mewakili penyelesaian asinkron operasi tulis.

Pengecualian

handle atau buffers adalah null.

handle tidak valid.

File ditutup.

File tidak mendukung pencarian (pipa atau soket).

fileOffset negatif.

handle tidak dibuka untuk menulis.

Terjadi kesalahan I/O.

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Posisi file tidak tingkat lanjut.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).

Berlaku untuk

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

Sumber:
RandomAccess.cs
Sumber:
RandomAccess.cs
Sumber:
RandomAccess.cs

Menulis urutan byte dari buffer yang diberikan ke file yang diberikan pada offset yang diberikan.

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

Parameter

handle
SafeFileHandle

Handel file.

buffer
ReadOnlyMemory<Byte>

Wilayah memori. Metode ini menyalin isi wilayah ini ke file.

fileOffset
Int64

Posisi file untuk ditulis.

cancellationToken
CancellationToken

Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.

Mengembalikan

Tugas yang mewakili penyelesaian asinkron operasi tulis.

Pengecualian

handleadalah null.

handle tidak valid.

File ditutup.

File tidak mendukung pencarian (pipa atau soket).

fileOffset negatif.

handle tidak dibuka untuk menulis.

Terjadi kesalahan I/O.

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Posisi file tidak tingkat lanjut.

Berlaku untuk