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

  • Başvuru

Tanım

Ad Alanı:
System.IO.Compression
Bütünleştirilmiş Kod:
System.IO.Compression.dll
Bütünleştirilmiş Kod:
System.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
DeflateStream.cs
Kaynak:
DeflateStream.cs
Kaynak:
DeflateStream.cs

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

public:
 override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public:
 override IAsyncResult ^ BeginRead(cli::array <System::Byte> ^ array, int offset, int count, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback? asyncCallback, object? asyncState);
public override IAsyncResult BeginRead (byte[] buffer, int offset, int count, AsyncCallback asyncCallback, object asyncState);
public override IAsyncResult BeginRead (byte[] array, int offset, int count, AsyncCallback asyncCallback, object asyncState);
override this.BeginRead : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
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
Public Overrides Function BeginRead (array As Byte(), offset As Integer, count As Integer, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametreler

bufferarray
Byte[]

Verilerin okunduğu bayt dizisi.

offset
Int32

Akıştan veri okumaya başlayabileceğiniz 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 istenen sayıda 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 G/Ç.

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, çağıran BeginRead aynı kodu kullanarak veya öğesine BeginReadgeçirilen bir geri çağırmada yapabilirsiniz.

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

Birden çok eşzamanlı zaman uyumsuz istek, isteğin tamamlanma 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.

Şunlara uygulanır