DeflateStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kodlar:

netstandard.dll, System.IO.Compression.dll

Kaynak:

DeflateStream.cs

Zaman uyumsuz bir okuma işlemi başlatır. (Bunun yerine yöntemini kullanmayı ReadAsync(Byte[], Int32, Int32) düşünün.)

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

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

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

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

Parametreler

buffer

Byte[]

Verilerin okunduğu bayt dizisi.

offset

Int32

Akıştan veri okumaya başlamak için bayt uzaklığı.

count

Int32

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

asyncCallback

AsyncCallback

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

asyncState

Object

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

Döndürülenler

IAsyncResult

Hala beklemede olabilecek zaman uyumsuz okuma işlemini temsil eden bir nesne.

Özel durumlar

IOException

yöntemi, akışın sonundan sonra zaman uyumsuz olarak okumaya çalıştı 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 DeflateStream uygulama okuma işlemini desteklemiyor.

InvalidOperationException

Bu çağrı tamamlanamıyor.

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.5'den başlayarak yöntemini kullanarak ReadAsync zaman uyumsuz okuma işlemleri gerçekleştirebilirsiniz. Yöntemi BeginRead , eski kodu desteklemek için geçerli sürümlerde hala kullanılabilir; ancak yeni zaman uyumsuz yöntemleri kullanarak zaman uyumsuz G/Ç işlemlerini daha kolay uygulayabilirsiniz. Daha fazla bilgi için bkz. Zaman Uyumsuz Dosya Girdi/Çıktı.

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. Bunu, olarak adlandırılan BeginRead 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 işlemi düzenlendiğinde güncelleştirilir.

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

Geçerli DeflateStream nesnenin CanRead 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 'den 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.