BufferedStream.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. (Erwägen Sie stattdessen die Verwendung WriteAsync(Byte[], Int32, Int32, CancellationToken) .)
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);public override IAsyncResult BeginWrite(byte[] buffer, int offset, int count, AsyncCallback callback, object? state);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, der 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 Objekt, das auf den asynchronen Schreibvorgang verweist, der noch aussteht.
Ausnahmen
buffer Länge Minus offset ist kleiner als count.
buffer ist null.
offset oder count ist negativ.
Der Datenstrom unterstützt das Schreiben nicht.
Hinweise
In .NET Framework 4 und früheren Versionen müssen Sie Methoden wie BeginWrite und EndWrite zum Implementieren asynchroner Dateivorgänge verwenden. Diese Methoden sind weiterhin in .NET Framework 4.5 verfügbar, um Legacycode zu unterstützen. Die neuen asynchronen Methoden, z ReadAsync. B. , WriteAsyncund FlushAsync, helfen Ihnen jedoch, asynchrone Dateivorgänge einfacher zu implementieren.
EndWritemuss genau einmal pro Jahr IAsyncResult aufgerufen werden.BeginWrite EndWrite wird blockiert, bis der E/A-Vorgang abgeschlossen ist.
