GZipStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) 메서드

정의

네임스페이스:

System.IO.Compression

어셈블리:

System.IO.Compression.dll

Source:

GZipStream.cs

비동기 읽기 작업을 시작합니다. (대신 ReadAsync(Byte[], Int32, Int32) 메서드를 사용하는 것이 좋습니다.)

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

매개 변수

buffer

Byte[]

데이터를 읽어 들일 바이트 배열입니다.

offset

Int32

스트림에서 데이터 읽기를 시작할 바이트 오프셋입니다.

count

Int32

읽을 최대 바이트 수입니다.

asyncCallback

AsyncCallback

읽기 작업이 완료되면 호출되는 선택적 비동기 콜백입니다.

asyncState

Object

다른 요청에서 특정 비동기 읽기 요청을 구별하는 사용자 제공 개체입니다.

반환

IAsyncResult

보류 중인 비동기 읽기 작업을 나타내는 개체입니다.

예외

IOException

메서드가 스트림의 끝을 지나 비동기 읽기를 시도했거나 디스크 오류가 발생했습니다.

ArgumentException

하나 이상의 인수가 잘못된 경우

ObjectDisposedException

스트림이 닫힌 후에 메서드가 호출되었습니다.

NotSupportedException

현재 GZipStream 구현이 읽기 작업을 지원하지 않는 경우

InvalidOperationException

스트림이 닫혀 있어서 읽기 작업을 수행할 수 없는 경우

설명

중요

.NET 6부터 이 메서드는 요청된 만큼 바이트를 읽지 않을 수 있습니다. 자세한 내용은 DeflateStream, GZipStream 및 CryptoStream의 부분 및 0바이트 읽기를 참조하세요.

.NET Framework 4.5부터 메서드를 사용하여 Stream.ReadAsync 비동기 읽기 작업을 수행할 수 있습니다. 메서드는 BeginRead 레거시 코드를 지원하기 위해 현재 버전에서 계속 사용할 수 있지만 새 비동기 메서드를 사용하여 비동기 I/O 작업을 보다 쉽게 구현할 수 있습니다. 자세한 내용은 비동기 파일 I/O를 참조하세요.

IAsyncResult 반환 값을 스트림의 메서드에 EndRead 전달하여 읽은 바이트 수를 확인하고 읽기에 사용되는 운영 체제 리소스를 해제합니다. 를 호출 BeginRead 한 동일한 코드를 사용하거나 에 전달된 BeginRead콜백에서 이 작업을 수행할 수 있습니다.

I/O 작업이 완료되는 경우가 아니라 비동기 읽기 또는 쓰기가 실행되면 스트림의 현재 위치가 업데이트됩니다.

여러 개의 동시 비동기 요청은 요청 완료 순서를 불확실하게 만듭니다.

현재 개체가 CanRead 읽기를 GZipStream 지원하는지 여부를 확인하려면 속성을 사용합니다.

스트림이 닫혀 있거나 잘못된 인수를 전달하면 예외가 에서 BeginRead즉시 throw됩니다. I/O 요청 중 디스크 오류와 같은 비동기 읽기 요청 중에 발생하는 오류는 스레드 풀 스레드에서 발생하고 를 호출 EndRead할 때 예외를 throw합니다.