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

Tanım

Ad Alanı:

System.Security.Cryptography

Bütünleştirilmiş Kod:

System.Security.Cryptography.dll

Kaynak:

CryptoStream.cs

Zaman uyumsuz bir yazma işlemi başlatır. (Bunun yerine kullanmayı WriteAsync 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[]

Veri yazacak arabellek.

offset

Int32

Yazmaya başlayabileceğiniz bayt uzaklığı buffer .

count

Int32

Yazacak en fazla bayt sayısı.

callback

AsyncCallback

Yazma işlemi tamamlandığında çağrılmak üzere isteğe bağlı bir zaman uyumsuz geri çağırma.

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

IAsyncResult Hala beklemede olabilecek zaman uyumsuz yazma işlemini temsil eden bir.

Özel durumlar

IOException

Akışın sonundan sonra zaman uyumsuz bir yazma girişiminde bulunulan veya bir disk hatası oluştu.

ArgumentException

Bir veya daha fazla bağımsız değişken geçersiz.

ObjectDisposedException

Akış kapatıldıktan sonra yöntemler çağrıldı.

NotSupportedException

Geçerli Stream uygulama yazma işlemini desteklemiyor.

Açıklamalar

.NET Framework 4 ve önceki sürümlerde, zaman uyumsuz G/Ç işlemleri uygulamak için ve EndWrite gibi BeginWrite yöntemleri kullanmanız gerekir. Bu yöntemler eski kodu desteklemek için geçerli sürümlerde hala kullanılabilir; ancak , , ve FlushAsyncgibi ReadAsyncWriteAsyncCopyToAsyncyeni zaman uyumsuz yöntemler, zaman uyumsuz G/Ç işlemlerini daha kolay uygulamanıza yardımcı olur.

Yazma işleminin IAsyncResult tamamlanmasını ve kaynakları uygun şekilde serbest kalmasını sağlamak için EndWrite geçerli yöntem tarafından döndürülen değerini geçirin. EndWrite her çağrısı BeginWriteiçin bir kez çağrılmalıdır. Bunu, çağrısıyla BeginWrite aynı kodu kullanarak veya öğesine BeginWritegeçirilen bir geri çağırmada kullanabilirsiniz. Zaman uyumsuz yazma sırasında bir hata oluşursa, bu yöntem tarafından döndürülen ile çağrılana IAsyncResult kadar EndWrite bir özel durum oluşmaz.

Bir akış yazılabilirse, akışın sonuna yazmak akışı genişletir.

Akıştaki geçerli konum, G/Ç işlemi tamamlandığında değil, zaman uyumsuz okuma veya yazma işlemi yaptığınızda güncelleştirilir. Birden çok eşzamanlı zaman uyumsuz istek, isteğin tamamlanma sırasını belirsiz hale getirir.

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın.

Bir akış kapatılırsa veya geçersiz bir bağımsız değişken geçirirseniz, özel durumlar hemen içinden BeginWriteoluşturulur. G/Ç isteği sırasında disk hatası gibi zaman uyumsuz yazma isteği sırasında oluşan hatalar, iş parçacığı havuzu iş parçacığında oluşur ve çağrılırken EndWriteözel durumlar oluşturur.