BufferedStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

BufferedStream.cs

Zaman uyumsuz bir yazma işlemi başlatır. (Bunun yerine kullanmayı WriteAsync(Byte[], Int32, Int32, CancellationToken) düşünün.)

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);

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

Parametreler

buffer

Byte[]

Geçerli akışa yazacak verileri içeren arabellek.

offset

Int32

Geçerli akışa bayt kopyalamaya başlanacak sıfır tabanlı bayt uzaklığı buffer .

count

Int32

Yazacak bayt sayısı üst sınırı.

callback

AsyncCallback

Zaman uyumsuz yazma işlemi tamamlandığında çağrılacak yöntem.

state

Object

Bu belirli zaman uyumsuz yazma isteğini diğer isteklerden ayıran kullanıcı tarafından sağlanan bir nesne.

Döndürülenler

IAsyncResult

Zaman uyumsuz yazma işlemine başvuran ve hala beklemede olabilecek bir nesne.

Özel durumlar

ArgumentException

buffer uzunluk eksi offset , değerinden countküçüktür.

ArgumentNullException

buffer, null'e eşittir.

ArgumentOutOfRangeException

offset veya count negatiftir.

NotSupportedException

Akış yazmayı desteklemiyor.

Açıklamalar

.NET Framework 4 ve önceki sürümlerinde, zaman uyumsuz dosya işlemleri uygulamak için ve BeginWrite gibi EndWrite yöntemleri kullanmanız gerekir. Bu yöntemler eski kodu desteklemek için .NET Framework 4.5'te hala kullanılabilir; ancak , ve ReadAsyncgibi WriteAsyncFlushAsyncyeni zaman uyumsuz yöntemler, zaman uyumsuz dosya işlemlerini daha kolay uygulamanıza yardımcı olur.

EndWriteher üzerinde IAsyncResulttam olarak bir kez BeginWrite çağrılmalıdır. EndWrite G/Ç işlemi tamamlanana kadar engellenir.