PipeStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Begint een asynchrone leesbewerking.
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 -> IAsyncResultPublic Overrides Function BeginRead (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResultParameters
- buffer
- Byte[]
De buffer om gegevens in te lezen.
- offset
- Int32
De byte-offset buffer waarin moet worden gelezen.
- count
- Int32
Het maximum aantal bytes dat moet worden gelezen.
- callback
- AsyncCallback
De methode die moet worden aangeroepen wanneer de asynchrone leesbewerking is voltooid.
- state
- Object
Een door de gebruiker verstrekt object dat deze specifieke asynchrone leesaanvraag onderscheidt van andere aanvragen.
Retouren
Een IAsyncResult object dat verwijst naar de asynchrone leesbewerking.
- Kenmerken
Uitzonderingen
buffer is null.
count is groter dan het aantal beschikbare bytes in buffer.
De pijp is gesloten.
De pijp biedt geen ondersteuning voor leesbewerkingen.
De sluis is losgekoppeld, wacht om verbinding te maken of de greep is niet ingesteld.
De pijp is verbroken of er is een andere I/O-fout opgetreden.
Opmerkingen
Geef het geretourneerde IAsyncResult object door aan de EndRead methode om te bepalen hoeveel bytes er zijn gelezen en om besturingssysteembronnen vrij te geven die worden gebruikt voor lezen. EndRead moet één keer worden gebeld voor elke oproep naar BeginRead. Dit kan worden gedaan in dezelfde code die wordt aangeroepen BeginRead of in een callback die wordt doorgegeven aan BeginRead.
Gebruik de CanRead eigenschap om te bepalen of het huidige PipeStream object leesbewerkingen ondersteunt.
Als de pijp is gesloten of een ongeldig argument wordt doorgegeven BeginRead, worden de juiste uitzonderingen onmiddellijk gegenereerd. Fouten die optreden tijdens een asynchrone leesaanvraag, treden op in de thread van de thread die de aanvraag uitvoert. De uitzonderingen worden gegenereerd wanneer de code de EndRead methode aanroept.
