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

Definition

Namnområde:
System.IO
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.Extensions.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll
Källa:
BufferedStream.cs
Källa:
BufferedStream.cs
Källa:
BufferedStream.cs
Källa:
BufferedStream.cs
Källa:
BufferedStream.cs

Påbörjar en asynkron skrivåtgärd. (Överväg att använda WriteAsync(Byte[], Int32, Int32, CancellationToken) i stället.)

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

Parametrar

buffer
Byte[]

Bufferten som innehåller data som ska skrivas till den aktuella strömmen.

offset
Int32

Den nollbaserade byteförskjutningen buffer där byte ska börja kopieras till den aktuella strömmen.

count
Int32

Det maximala antalet byte som ska skrivas.

callback
AsyncCallback

Den metod som ska anropas när den asynkrona skrivåtgärden har slutförts.

state
Object

Ett objekt som tillhandahålls av användaren och som skiljer den här specifika asynkrona skrivbegäran från andra begäranden.

Returer

IAsyncResult

Ett objekt som refererar till den asynkrona skrivning som fortfarande kan vänta.

Undantag

ArgumentException

buffer längden minus offset är mindre än count.

ArgumentNullException

buffer är null.

ArgumentOutOfRangeException

offset eller count är negativ.

NotSupportedException

Strömmen stöder inte skrivning.

Kommentarer

I .NET Framework 4 och tidigare versioner måste du använda metoder som BeginWrite och EndWrite för att implementera asynkrona filåtgärder. Dessa metoder är fortfarande tillgängliga i .NET Framework 4.5 för att stödja äldre kod. De nya asynkrona metoderna, till exempel ReadAsync, WriteAsync och FlushAsync, hjälper dig att implementera asynkrona filåtgärder enklare.

EndWrite måste anropas exakt en gång på varje IAsyncResult från BeginWrite. EndWrite blockeras tills I/O-åtgärden har slutförts.

Gäller för