Stream.ReadExactlyAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
ReadExactlyAsync(Memory<Byte>, CancellationToken) |
현재 스트림에서 바이트를 비동기적으로 읽고, 가 채워질 때까지 |
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken) |
현재 스트림에서 바이트 수를 비동기적으로 읽고 |
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
매개 변수
- 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
인 경우
offset
가 buffer
의 범위 밖인 경우
또는
count
가 음수입니다.
또는
및 count
의 offset
조합으로 지정된 범위가 의 buffer
길이를 초과합니다.
스트림의 끝에 도달한 후 바이트 수를 읽 count
습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
가 0이면 count
스트림에서 사용 가능한 데이터를 기다리지 않고 이 읽기 작업이 완료됩니다.
이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw ReadExactly(Byte[], Int32, Int32)된 예외를 참조하세요.
적용 대상
.NET