다음을 통해 공유


Stream.ReadExactlyAsync 메서드

정의

오버로드

ReadExactlyAsync(Memory<Byte>, CancellationToken)

현재 스트림에서 바이트를 비동기적으로 읽고, 가 채워질 때까지 buffer 스트림 내의 위치를 발전시키고, 취소 요청을 모니터링합니다.

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

현재 스트림에서 바이트 수를 비동기적으로 읽고 count , 스트림 내의 위치를 확장하고, 취소 요청을 모니터링합니다.

ReadExactlyAsync(Memory<Byte>, CancellationToken)

Source:
Stream.cs
Source:
Stream.cs
Source:
Stream.cs

현재 스트림에서 바이트를 비동기적으로 읽고, 가 채워질 때까지 buffer 스트림 내의 위치를 발전시키고, 취소 요청을 모니터링합니다.

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

매개 변수

buffer
Memory<Byte>

데이터를 쓸 버퍼입니다.

cancellationToken
CancellationToken

취소 요청을 모니터링할 토큰입니다.

반환

비동기 읽기 작업을 나타내는 작업입니다.

예외

스트림의 끝에 도달한 후 를 buffer채웁니다.

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

buffer 가 비어 있으면 스트림에서 사용 가능한 데이터를 기다리지 않고 이 읽기 작업이 완료됩니다.

적용 대상

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

Source:
Stream.cs
Source:
Stream.cs
Source:
Stream.cs

현재 스트림에서 바이트 수를 비동기적으로 읽고 count , 스트림 내의 위치를 확장하고, 취소 요청을 모니터링합니다.

public System.Threading.Tasks.ValueTask ReadExactlyAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken = default);
member this.ReadExactlyAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function ReadExactlyAsync (buffer As Byte(), offset As Integer, count As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

매개 변수

buffer
Byte[]

데이터를 쓸 버퍼입니다.

offset
Int32

스트림의 데이터를 쓰기 시작할 buffer의 바이트 오프셋입니다.

count
Int32

현재 스트림에서 읽을 바이트 수입니다.

cancellationToken
CancellationToken

취소 요청을 모니터링할 토큰입니다.

반환

비동기 읽기 작업을 나타내는 작업입니다.

예외

buffer이(가) null인 경우

offsetbuffer의 범위 밖인 경우

또는

count가 음수입니다.

또는

countoffset 조합으로 지정된 범위가 의 buffer길이를 초과합니다.

스트림의 끝에 도달한 후 바이트 수를 읽 count 습니다.

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

가 0이면 count 스트림에서 사용 가능한 데이터를 기다리지 않고 이 읽기 작업이 완료됩니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw ReadExactly(Byte[], Int32, Int32)된 예외를 참조하세요.

적용 대상