DeflateStream.ReadAsync 메서드

정의

오버로드

ReadAsync(Memory<Byte>, CancellationToken)

현재 Deflate 스트림에서 바이트의 시퀀스를 비동기적으로 읽고, 이를 바이트 메모리 범위에 쓰고, 읽은 바이트 수만큼 Deflate 스트림 내에서 앞으로 이동하며, 취소 요청을 모니터링합니다.Asynchronously reads a sequence of bytes from the current Deflate stream, writes them to a byte memory range, advances the position within the Deflate stream by the number of bytes read, and monitors cancellation requests.

ReadAsync(Byte[], Int32, Int32, CancellationToken)

현재 Deflate 스트림에서 바이트의 시퀀스를 비동기적으로 읽고, 이를 바이트 배열에 쓰고, 읽은 바이트 수만큼 Deflate 스트림 내에서 앞으로 이동하며, 취소 요청을 모니터링합니다.Asynchronously reads a sequence of bytes from the current Deflate stream, writes them to a byte array, advances the position within the Deflate stream by the number of bytes read, and monitors cancellation requests.

ReadAsync(Memory<Byte>, CancellationToken)

현재 Deflate 스트림에서 바이트의 시퀀스를 비동기적으로 읽고, 이를 바이트 메모리 범위에 쓰고, 읽은 바이트 수만큼 Deflate 스트림 내에서 앞으로 이동하며, 취소 요청을 모니터링합니다.Asynchronously reads a sequence of bytes from the current Deflate stream, writes them to a byte memory range, advances the position within the Deflate stream by the number of bytes read, and monitors cancellation requests.

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

매개 변수

buffer
Memory<Byte>

데이터를 기록할 메모리의 영역입니다.The region of memory to write the data into.

cancellationToken
CancellationToken

취소 요청을 모니터링할 토큰입니다.The token to monitor for cancellation requests. 기본값은 None입니다.The default value is None.

반환

ValueTask<Int32>

비동기 읽기 작업을 나타내며 버퍼로 읽은 총 바이트 수를 래핑하는 태스크입니다.A task that represents the asynchronous read operation, which wraps the total number of bytes read into the buffer. 결과 값은 많은 바이트가 현재 사용 가능하지 않은 경우 버퍼에 할당된 바이트 수보다 작을 수 있으며 Deflate 스트림의 끝에 도달하면 0이 될 수 있습니다.The result value can be less than the number of bytes allocated in the buffer if that many bytes are not currently available, or it can be 0 (zero) if the end of the Deflate stream has been reached.

설명

ReadAsync메서드를 사용 하면 주 스레드를 차단 하지 않고 리소스를 많이 사용 하는 i/o 작업을 수행할 수 있습니다.The ReadAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. 이 성능 고려 사항은 시간이 걸리는 스트림 작업이 UI 스레드를 차단하여 앱이 작동하지 않는 것처럼 보일 수 있는 Windows 8.x 스토어 앱 또는 데스크톱 앱에서 특히 중요합니다.This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. 비동기 메서드는 async await Visual Basic 및 c #의 및 키워드와 함께 사용 됩니다.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

CanRead현재 인스턴스에서 읽기를 지원 하는지 여부를 확인 하려면 속성을 사용 합니다.Use the CanRead property to determine whether the current instance supports reading.

작업이 완료 되기 전에 취소 되는 경우 반환 된 작업에는 TaskStatus.Canceled 속성에 대 한 값이 포함 됩니다 Task.Status .If the operation is canceled before it completes, the returned task contains the TaskStatus.Canceled value for the Task.Status property.

적용 대상

ReadAsync(Byte[], Int32, Int32, CancellationToken)

현재 Deflate 스트림에서 바이트의 시퀀스를 비동기적으로 읽고, 이를 바이트 배열에 쓰고, 읽은 바이트 수만큼 Deflate 스트림 내에서 앞으로 이동하며, 취소 요청을 모니터링합니다.Asynchronously reads a sequence of bytes from the current Deflate stream, writes them to a byte array, advances the position within the Deflate stream by the number of bytes read, and monitors cancellation requests.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ array, int offset, int count, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<int> ReadAsync (byte[] array, int offset, int count, System.Threading.CancellationToken cancellationToken);
override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public Overrides Function ReadAsync (array As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

매개 변수

array
Byte[]

데이터를 쓸 버퍼입니다.The buffer to write the data into.

offset
Int32

Deflate 스트림의 데이터를 쓰기 시작할 array의 바이트 오프셋입니다.The byte offset in array at which to begin writing data from the Deflate stream.

count
Int32

읽을 최대 바이트 수입니다.The maximum number of bytes to read.

cancellationToken
CancellationToken

취소 요청을 모니터링할 토큰입니다.The token to monitor for cancellation requests. 기본값은 None입니다.The default value is None.

반환

Task<Int32>

비동기 읽기 작업을 나타내며 array로 읽은 총 바이트 수를 래핑하는 태스크입니다.A task that represents the asynchronous read operation, which wraps the total number of bytes read into the array. 현재 사용할 수 있는 바이트 수가 요청된 수보다 작을 경우 결과 값이 요청된 바이트 수보다 작을 수 있으며 Deflate 스트림의 끝에 도달한 경우에는 0이 될 수도 있습니다.The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the Deflate stream has been reached.

설명

ReadAsync메서드를 사용 하면 주 스레드를 차단 하지 않고 리소스를 많이 사용 하는 i/o 작업을 수행할 수 있습니다.The ReadAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. 이 성능 고려 사항은 시간이 걸리는 스트림 작업이 UI 스레드를 차단하여 앱이 작동하지 않는 것처럼 보일 수 있는 Windows 8.x 스토어 앱 또는 데스크톱 앱에서 특히 중요합니다.This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. 비동기 메서드는 async await Visual Basic 및 c #의 및 키워드와 함께 사용 됩니다.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

CanRead현재 인스턴스에서 읽기를 지원 하는지 여부를 확인 하려면 속성을 사용 합니다.Use the CanRead property to determine whether the current instance supports reading.

작업이 완료 되기 전에 취소 되는 경우 반환 된 작업에는 TaskStatus.Canceled 속성에 대 한 값이 포함 됩니다 Task.Status .If the operation is canceled before it completes, the returned task contains the TaskStatus.Canceled value for the Task.Status property.

적용 대상