IsolatedStorageFileStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Metoda

Definicja

Rozpoczyna odczyt asynchroniczny.Begins an asynchronous read.

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

Parametry

bufferarray
Byte[]

Bufor, do którego mają zostać odczytane dane.The buffer to read data into.

offset
Int32

Przesunięcie bajtu w buffer czasie, w którym ma zostać rozpoczęte odczytywanie.The byte offset in buffer at which to begin reading.

numBytes
Int32

Maksymalna liczba bajtów do odczytania.The maximum number of bytes to read.

userCallback
AsyncCallback

Metoda wywoływana po zakończeniu asynchronicznej operacji odczytu.The method to call when the asynchronous read operation is completed. Ten parametr jest opcjonalny.This parameter is optional.

stateObject
Object

Stan odczytu asynchronicznego.The status of the asynchronous read.

Zwraca

IAsyncResult

IAsyncResultObiekt, który reprezentuje asynchroniczny odczyt, który jest prawdopodobnie nadal w stanie oczekiwania.An IAsyncResult object that represents the asynchronous read, which is possibly still pending. IAsyncResult EndRead(IAsyncResult) Aby określić liczbę bajtów, które zostały odczytane, należy je przesłać do metody tego strumienia.This IAsyncResult must be passed to this stream's EndRead(IAsyncResult) method to determine how many bytes were read. Można to zrobić przy użyciu tego samego kodu, który został wywołany, BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) lub w wywołaniu zwrotnym przekazanym do BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) .This can be done either by the same code that called BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) or in a callback passed to BeginRead(Byte[], Int32, Int32, AsyncCallback, Object).

Wyjątki

Podjęto próbę odczytu asynchronicznego poza końcem pliku.An asynchronous read was attempted past the end of the file.

Uwagi

Bieżące położenie w strumieniu jest aktualizowane, gdy zostanie wystawiony asynchroniczny odczyt lub zapis, a nie po zakończeniu operacji we/wy.The current position in the stream is updated when you issue the asynchronous read or write, not when the I/O operation completes.

Musisz wywołać EndRead tę metodę IAsyncResult , aby dowiedzieć się, ile bajtów zostało odczytanych.You must call EndRead with this IAsyncResult to find out how many bytes were read.

Dotyczy