PipeStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Methode

Definitie

Hiermee wordt een asynchrone schrijfbewerking gestart.

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

Parameters

buffer
Byte[]

De buffer die de gegevens bevat die naar de huidige stroom moeten worden geschreven.

offset
Int32

De byte-offset buffer op basis van nul waarmee bytes naar de huidige stroom worden gekopieerd.

count
Int32

Het maximum aantal bytes dat moet worden geschreven.

callback
AsyncCallback

De methode die moet worden aangeroepen wanneer de asynchrone schrijfbewerking is voltooid.

state
Object

Een door de gebruiker verstrekt object dat deze specifieke asynchrone schrijfaanvraag onderscheidt van andere aanvragen.

Retouren

Een IAsyncResult object dat verwijst naar de asynchrone schrijfbewerking.

Kenmerken

Uitzonderingen

buffer is null.

offset is kleiner dan 0.

– of –

count is kleiner dan 0.

count is groter dan het aantal beschikbare bytes in buffer.

De pijp is gesloten.

De pijp biedt geen ondersteuning voor schrijfbewerkingen.

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

EndWrite moet één keer worden gebeld voor elke oproep naar BeginWrite. Dit kan worden gedaan in dezelfde code die wordt aangeroepen BeginWrite of in een callback die wordt doorgegeven aan BeginWrite.

Gebruik de CanWrite eigenschap om te bepalen of het huidige PipeStream object schrijfbewerkingen ondersteunt.

Als de pijp is gesloten of een ongeldig argument wordt doorgegeven BeginWrite, worden de juiste uitzonderingen onmiddellijk gegenereerd. Fouten die optreden tijdens een asynchrone schrijfaanvraag, vinden plaats in de thread van de thread die de aanvraag uitvoert. De uitzonderingen worden gegenereerd wanneer de code de EndWrite methode aanroept.

Van toepassing op