RandomAccess.ReadAsync Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Overload

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)	Membaca urutan byte dari file yang diberikan pada offset tertentu.
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)	Membaca urutan byte dari file yang diberikan pada offset tertentu.

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)

Sumber:

RandomAccess.cs

Membaca urutan byte dari file yang diberikan pada offset tertentu.

public static System.Threading.Tasks.ValueTask<long> ReadAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);

static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int64>

Public Shared Function ReadAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Long)

Parameter

handle

SafeFileHandle

Handel file.

buffers

IReadOnlyList<Memory<Byte>>

Daftar buffer memori. Ketika metode ini kembali, konten buffer ini digantikan oleh byte yang dibaca dari file.

fileOffset

Int64

Posisi file untuk dibaca.

cancellationToken

CancellationToken

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

Mengembalikan

ValueTask<Int64>

Jumlah total byte yang dibaca ke dalam buffer. Ini bisa kurang dari jumlah byte yang dialokasikan di buffer jika banyak byte saat ini tidak tersedia, atau nol (0) jika akhir file telah tercapai.

Pengecualian

ArgumentNullException

handle atau buffers adalah null.

ArgumentException

handle tidak valid.

ObjectDisposedException

File ditutup.

NotSupportedException

File tidak mendukung pencarian (pipa atau soket).

ArgumentOutOfRangeException

fileOffset negatif.

UnauthorizedAccessException

handle tidak dibuka untuk dibaca.

IOException

Terjadi kesalahan I/O.

OperationCanceledException

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

Keterangan

Posisi file tidak tingkat lanjut.

Metode ini disimpan dalam tugas yang menampilkan 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 Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64).

ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)

Sumber:

RandomAccess.cs

Membaca urutan byte dari file yang diberikan pada offset tertentu.

public static System.Threading.Tasks.ValueTask<int> ReadAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, Memory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);

static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * Memory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Shared Function ReadAsync (handle As SafeFileHandle, buffer As Memory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parameter

handle

SafeFileHandle

Handel file.

buffer

Memory<Byte>

Wilayah memori. Ketika metode ini kembali, konten wilayah ini digantikan oleh byte yang dibaca dari file.

fileOffset

Int64

Posisi file untuk dibaca.

cancellationToken

CancellationToken

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

Mengembalikan

ValueTask<Int32>

Jumlah total byte yang dibaca ke dalam buffer. Ini bisa kurang dari jumlah byte yang dialokasikan di buffer jika banyak byte saat ini tidak tersedia, atau nol (0) jika akhir file telah tercapai.

Pengecualian

ArgumentNullException

handleadalah null.

ArgumentException

handle tidak valid.

ObjectDisposedException

File ditutup.

NotSupportedException

File tidak mendukung pencarian (pipa atau soket).

ArgumentOutOfRangeException

fileOffset negatif.

UnauthorizedAccessException

handle tidak dibuka untuk dibaca.

IOException

Terjadi kesalahan I/O.

OperationCanceledException

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

Keterangan

Posisi file tidak tingkat lanjut.