UnmanagedMemoryStream.ReadAsync 메서드

정의

오버로드

Name Description
ReadAsync(Memory<Byte>, CancellationToken)

관리되지 않는 메모리 스트림 바이트를 메모리 영역으로 비동기적으로 읽습니다.

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

지정된 바이트 수를 지정된 배열로 비동기적으로 읽습니다.

ReadAsync(Memory<Byte>, CancellationToken)

Source:
UnmanagedMemoryStream.cs
Source:
UnmanagedMemoryStream.cs
Source:
UnmanagedMemoryStream.cs
Source:
UnmanagedMemoryStream.cs
Source:
UnmanagedMemoryStream.cs

관리되지 않는 메모리 스트림 바이트를 메모리 영역으로 비동기적으로 읽습니다.

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>

비동기 메서드가 완료되면 이 메모리 영역에는 관리되지 않는 메모리 스트림에서 읽은 모든 바이트가 포함됩니다.

cancellationToken
CancellationToken

취소 요청을 모니터링할 토큰입니다. 기본값은 None입니다.

반품

비동기 읽기 작업을 나타내고 버퍼에 읽은 총 바이트 수를 래핑하는 작업입니다.

예외

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

적용 대상

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

Source:
UnmanagedMemoryStream.cs
Source:
UnmanagedMemoryStream.cs
Source:
UnmanagedMemoryStream.cs
Source:
UnmanagedMemoryStream.cs
Source:
UnmanagedMemoryStream.cs

지정된 바이트 수를 지정된 배열로 비동기적으로 읽습니다.

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

매개 변수

buffer
Byte[]

데이터를 쓸 버퍼입니다.

offset
Int32

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

count
Int32

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

cancellationToken
CancellationToken

취소 요청을 모니터링할 토큰입니다. 기본값은 None입니다.

반품

비동기 읽기 작업을 나타내는 작업입니다. 매개 변수 값 TResult 에는 버퍼로 읽은 총 바이트 수가 포함됩니다. 현재 사용할 수 있는 바이트 수가 요청된 수보다 작거나 스트림의 끝에 도달한 경우 0이 될 수 있는 경우 결과 값은 요청된 바이트 수보다 작을 수 있습니다.

특성

예외

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

설명

읽기 작업 중에 예외가 발생하면 반환된 작업의 속성으로 Task.Exception 설정됩니다.

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

적용 대상