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

Referenz

Definition

Namespace:: System.IO

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: BufferedStream.cs

Quelle:: BufferedStream.cs

Quelle:: BufferedStream.cs

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. (Verwenden Sie stattdessen 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 -> 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 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 werden soll, wenn der asynchrone Schreibvorgang abgeschlossen ist.

state: Object

Ein vom Benutzer bereitgestelltes Objekt, das diese asynchrone Schreibanforderung von anderen Anforderungen unterscheidet.

Gibt zurück

IAsyncResult

Ein Objekt, das auf den asynchronen Schreibvorgang verweist, der möglicherweise noch aussteht.

Ausnahmen

ArgumentException

Die Länge von buffer minus offset ist kleiner als count.

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

offset oder count ist ein negativer Wert.

NotSupportedException

Der Stream unterstützt das Schreiben nicht.

Hinweise

In der .NET Framework 4 und früheren Versionen erforderlich, wie z. B. BeginWrite und EndWrite , asynchrone Datei-Vorgänge zu implementieren. Diese Methoden sind weiterhin im .NET Framework 4.5 verfügbar, um Legacycode zu unterstützen. Die neuen asynchronen Methoden wie ReadAsync, WriteAsyncund FlushAsynchelfen Ihnen jedoch, asynchrone Dateivorgänge einfacher zu implementieren.

EndWrite muss für jede IAsyncResult von BeginWritegenau einmal aufgerufen werden. EndWrite wird blockiert, bis der E/A-Vorgang abgeschlossen ist.

Gilt für: