CryptoStream.BeginRead(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 okuma işlemi başlatır. (Bunun yerine kullanmayı ReadAsync düşünün.)

public:
 override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);

public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);

override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult

Public Overrides Function BeginRead (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parametreler

buffer

Byte[]

Verilerin okunması için arabellek.

offset

Int32

Akıştan okunan verileri yazmaya başlamak için bayt uzaklığı buffer .

count

Int32

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

callback

AsyncCallback

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

state

Object

Bu belirli zaman uyumsuz okuma 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 okumayı temsil eden bir.

Özel durumlar

IOException

Akışın sonundan sonra zaman uyumsuz bir okuma işlemi denendi 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 okuma işlemini desteklemiyor.

Açıklamalar

Önemli

.NET 6'dan başlayarak, bu yöntem istendiği kadar bayt okumayabilir. Daha fazla bilgi için bkz. DeflateStream, GZipStream ve CryptoStream'de kısmi ve sıfır bayt okumaları.

.NET Framework 4 ve önceki sürümlerde, zaman uyumsuz G/Ç işlemleri uygulamak için ve EndRead gibi BeginRead 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.

IAsyncResult Okunan bayt sayısını belirlemek ve okuma için kullanılan işletim sistemi kaynaklarını serbest bırakmak için dönüş değerini EndRead akışın yöntemine geçirin. EndRead her çağrısı BeginReadiçin bir kez çağrılmalıdır. Bunu, çağrısıyla BeginRead aynı kodu kullanarak veya öğesine BeginReadgeçirilen bir geri çağırmada kullanabilirsiniz.

Akıştaki geçerli konum, G/Ç işlemi tamamlandığında değil, zaman uyumsuz okuma veya yazma yayımlandığında güncelleştirilir.

Birden çok eşzamanlı zaman uyumsuz istek, isteğin tamamlanma sırasını belirsiz hale getirir.

CanRead Geçerli örneğin okumayı 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 BeginReadoluşturulur. G/Ç isteği sırasında disk hatası gibi zaman uyumsuz bir okuma isteği sırasında oluşan hatalar, iş parçacığı havuzu iş parçacığında oluşur ve çağrılırken EndReadözel durumlar oluşturur.