RandomAccess.Read Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Overload

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

Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)

Sumber:

RandomAccess.cs

Membaca urutan byte dari file yang diberikan pada offset tertentu.

public:
 static long Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::Collections::Generic::IReadOnlyList<Memory<System::Byte>> ^ buffers, long fileOffset);

public static long Read (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset);

static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 -> int64

Public Shared Function Read (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long) As Long

Parameter

handle

SafeFileHandle

Handel file.

buffers

IReadOnlyList<Memory<Byte>>

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

fileOffset

Int64

Posisi file untuk dibaca.

Mengembalikan

Int64

Jumlah total byte yang dibaca ke dalam buffer. Ini bisa kurang dari jumlah byte yang dialokasikan dalam 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.

Keterangan

Posisi file tidak tingkat lanjut.

Read(SafeFileHandle, Span<Byte>, Int64)

Sumber:

RandomAccess.cs

Membaca urutan byte dari file yang diberikan pada offset tertentu.

public:
 static int Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, Span<System::Byte> buffer, long fileOffset);

public static int Read (Microsoft.Win32.SafeHandles.SafeFileHandle handle, Span<byte> buffer, long fileOffset);

static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * Span<byte> * int64 -> int

Public Shared Function Read (handle As SafeFileHandle, buffer As Span(Of Byte), fileOffset As Long) As Integer

Parameter

handle

SafeFileHandle

Handel file.

buffer

Span<Byte>

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

fileOffset

Int64

Posisi file untuk dibaca.

Mengembalikan

Int32

Jumlah total byte yang dibaca ke dalam buffer. Ini bisa kurang dari jumlah byte yang dialokasikan dalam 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.

Keterangan

Posisi file tidak tingkat lanjut.