PipeStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Beginnt einen asynchronen Schreibvorgang.
public:
override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);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]
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object state);override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult[<System.Security.SecurityCritical>]
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResultPublic Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResultParameter
- buffer
- Byte[]
Der Puffer mit den Daten, die in den aktuellen Stream geschrieben werden sollen.
- offset
- Int32
Der nullbasierte Byteoffset im buffer, ab dem Bytes in den aktuellen Stream kopiert werden.
- count
- Int32
Die maximale Anzahl der zu schreibenden Bytes.
- callback
- AsyncCallback
Die Methode, die aufgerufen wird, wenn die asynchrone Schreiboperation abgeschlossen ist.
- state
- Object
Ein vom Benutzer bereitgestelltes Objekt, das diese asynchrone Schreibanforderung von anderen Anforderungen unterscheidet.
Gibt zurück
Ein IAsyncResult-Objekt, das auf den asynchronen Schreibvorgang verweist.
- Attribute
Ausnahmen
buffer ist null.
count ist größer als die im buffer verfügbare Anzahl von Bytes.
Die Pipe ist geschlossen.
Die Pipe unterstützt keine Schreibvorgänge.
Die Verbindung der Pipe ist getrennt, die Pipe wartet auf eine Verbindung, oder das Handle wurde nicht festgelegt.
Die Pipe wurde unterbrochen, oder es ist ein anderer E/A-Fehler aufgetreten.
Hinweise
EndWrite muss einmal für jeden Aufruf von BeginWriteaufgerufen werden. Dies kann entweder im gleichen Code erfolgen, der aufgerufen hat BeginWrite , oder in einem Rückruf, der an BeginWriteübergeben wird.
Verwenden Sie die CanWrite -Eigenschaft, um zu bestimmen, ob das aktuelle PipeStream Objekt Schreibvorgänge unterstützt.
Wenn die Pipe geschlossen oder ein ungültiges Argument an BeginWriteübergeben wird, werden die entsprechenden Ausnahmen sofort ausgelöst. Fehler, die während einer asynchronen Schreibanforderung auftreten, treten im Threadpoolthread auf, der die Anforderung ausführt. Die Ausnahmen werden ausgelöst, wenn der Code die EndWrite -Methode aufruft.
