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.
Startet 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 -> IAsyncResult
Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult
Parameter
- buffer
- Byte[]
Der Puffer, der die Daten enthält, die in den aktuellen Datenstrom geschrieben werden sollen.
- offset
- Int32
Der nullbasierte Byte-Offset, in buffer dem mit dem Kopieren von Bytes in den aktuellen Datenstrom begonnen werden soll.
- count
- Int32
Die maximale Anzahl von Bytes, die geschrieben werden sollen.
- callback
- AsyncCallback
Die Methode, die aufgerufen werden soll, wenn der asynchrone Schreibvorgang abgeschlossen ist.
- state
- Object
Ein vom Benutzer bereitgestelltes Objekt, das diese spezielle 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 Anzahl der in buffer.
Das Rohr ist geschlossen.
Die Pipe unterstützt keine Schreibvorgänge.
Die Leitung ist getrennt, wartet auf die Verbindung, oder der Ziehpunkt wurde nicht festgelegt.
Die Pfeife ist unterbrochen, oder ein anderer E/A-Fehler ist aufgetreten.
Hinweise
EndWritemuss einmal für jeden Anruf aufgerufen werden.BeginWrite Dies kann entweder im gleichen Code erfolgen, der aufgerufen BeginWrite wird, oder in einem Rückruf, der BeginWritean die Ü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 übergeben BeginWritewird, 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.