다음을 통해 공유


NegotiateStream.ReadAsync 메서드

정의

오버로드

ReadAsync(Memory<Byte>, CancellationToken)

NegotiateStream에서 비동기적으로 데이터를 읽고 비동기 작업으로 바이트 메모리 범위에 저장합니다.

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

이 스트림에서 비동기적으로 데이터를 읽어 지정된 배열에 저장합니다.

ReadAsync(Memory<Byte>, CancellationToken)

Source:
NegotiateStream.cs
Source:
NegotiateStream.cs
Source:
NegotiateStream.cs

NegotiateStream에서 비동기적으로 데이터를 읽고 비동기 작업으로 바이트 메모리 범위에 저장합니다.

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

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

반환

비동기 읽기 작업을 나타내는 ValueTask<TResult>입니다. 해당 Result 속성의 값에는 buffer 안으로 읽은 총 바이트 수가 포함됩니다.

예외

읽기 작업이 실패한 경우.

인증이 수행되지 않은 경우

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

설명

이 메서드는 사용할 수 있는 buffer 만큼의 데이터를 비동기적으로 읽고 성공적으로 읽은 바이트 수를 반환합니다.

성공적으로 인증될 때까지 이 메서드를 호출할 수 없습니다. 인증하려면 , , , AuthenticateAsClientAsync, AuthenticateAsServerAsyncBeginAuthenticateAsClientAuthenticateAsServer또는 BeginAuthenticateAsServer 메서드 중 AuthenticateAsClient하나를 호출합니다.

적용 대상

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

Source:
NegotiateStream.cs
Source:
NegotiateStream.cs
Source:
NegotiateStream.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);
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[]

스트림에서 읽은 바이트를 받는 Byte 배열입니다.

offset
Int32

이 스트림에서 읽은 데이터를 저장하기 시작하는, buffer 내의 0부터 시작하는 위치가 포함된 Int32입니다.

count
Int32

스트림에서 읽을 최대 바이트 수가 포함된 Int32입니다.

cancellationToken
CancellationToken

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

반환

내부 스트림에서 읽은 바이트 수를 지정하는 Int32 값입니다. 읽을 데이터가 더 이상 없으면 0이 반환됩니다.

예외

읽기 작업이 실패한 경우.

인증이 수행되지 않은 경우

Read(Byte[], Int32, Int32) 작업이 이미 진행 중인 경우.

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

설명

메서드는 현재 스트림에서 최대 count 바이트를 비동기적으로 읽고 부터 offset에 저장합니다buffer.

성공적으로 인증될 때까지 이 메서드를 호출할 수 없습니다. 인증하려면 , , , AuthenticateAsClientAsync, AuthenticateAsServerAsyncBeginAuthenticateAsClientAuthenticateAsServer또는 BeginAuthenticateAsServer 메서드 중 AuthenticateAsClient하나를 호출합니다.

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

적용 대상