Share via


PipeStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Metode

Definisi

Memulai operasi baca asinkron.

public:
 override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);
public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);
public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
[System.Security.SecurityCritical]
public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
[<System.Security.SecurityCritical>]
override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overrides Function BeginRead (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

buffer
Byte[]

Buffer untuk membaca data.

offset
Int32

Offset byte untuk buffer mulai membaca.

count
Int32

Jumlah maksimum byte yang akan dibaca.

callback
AsyncCallback

Metode untuk memanggil ketika operasi baca asinkron selesai.

state
Object

Objek yang disediakan pengguna yang membedakan permintaan baca asinkron khusus ini dari permintaan lain.

Mengembalikan

Objek IAsyncResult yang mereferensikan pembacaan asinkron.

Atribut

Pengecualian

bufferadalah null.

offset kurang dari 0.

-atau-

count kurang dari 0.

count lebih besar dari jumlah byte yang tersedia di buffer.

Pipa ditutup.

Pipa tidak mendukung operasi baca.

Pipa terputus, menunggu untuk tersambung, atau handel belum diatur.

Pipa rusak atau terjadi kesalahan I/O lainnya.

Keterangan

Teruskan objek yang dikembalikan IAsyncResult ke EndRead metode untuk menentukan berapa banyak byte yang dibaca dan untuk merilis sumber daya sistem operasi yang digunakan untuk membaca. EndRead harus dipanggil sekali untuk setiap panggilan ke BeginRead. Ini dapat dilakukan baik dalam kode yang sama yang memanggil BeginRead atau dalam panggilan balik yang diteruskan ke BeginRead.

CanRead Gunakan properti untuk menentukan apakah objek saat ini PipeStream mendukung operasi baca.

Jika pipa ditutup atau argumen yang tidak valid diteruskan ke BeginRead, pengecualian yang sesuai segera dinaikkan. Kesalahan yang terjadi selama permintaan baca asinkron terjadi pada utas kumpulan utas yang melakukan permintaan. Pengecualian dimunculkan ketika kode memanggil EndRead metode .

Berlaku untuk