다음을 통해 공유


NetworkStream.ReadAsync 메서드

정의

오버로드

ReadAsync(Memory<Byte>, CancellationToken)

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

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

NetworkStream에서 데이터를 읽고 비동기 작업으로 지정된 범위의 바이트 배열에 저장합니다.

ReadAsync(Memory<Byte>, CancellationToken)

Source:
NetworkStream.cs
Source:
NetworkStream.cs
Source:
NetworkStream.cs

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

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 안으로 읽은 총 바이트 수가 포함됩니다.

예외

NetworkStream이 읽기를 지원하지 않습니다.

소켓에 액세스할 때 오류가 발생했습니다.

또는

네트워크에서 읽는 동안 오류가 발생한 경우

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

설명

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

참고

를 호출 CanRead 하여 가 NetworkStream 읽을 수 있는지 확인합니다. 읽을 수 없는 에서 NetworkStream 읽으려고 하면 가 InvalidOperationException표시됩니다.

참고

를 수신하는 IOException경우 속성을 검사 InnerException 속성이 로 SocketException인해 발생했는지 확인합니다. 이 경우 속성을 사용하여 ErrorCode 특정 오류 코드를 가져오고 Windows 소켓 버전 2 API 오류 코드 설명서를 참조하여 오류에 대한 자세한 설명을 참조하세요.

적용 대상

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

Source:
NetworkStream.cs
Source:
NetworkStream.cs
Source:
NetworkStream.cs

NetworkStream에서 데이터를 읽고 비동기 작업으로 지정된 범위의 바이트 배열에 저장합니다.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int size, System::Threading::CancellationToken cancellationToken);
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 size, 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>
override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As Task(Of Integer)
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 내의 위치입니다.

sizecount
Int32

NetworkStream에서 읽을 바이트 수입니다.

cancellationToken
CancellationToken

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

반환

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

예외

NetworkStream이 읽기를 지원하지 않습니다.

소켓에 액세스할 때 오류가 발생했습니다.

또는

네트워크에서 읽는 동안 오류가 발생한 경우

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

설명

이 메서드는 데이터를 로 읽고 buffer 성공적으로 읽은 바이트 수를 반환합니다. 이 ReadAsync 작업은 매개 변수에 지정된 size 바이트 수까지 사용 가능한 만큼의 데이터를 읽습니다.

참고

를 호출 CanRead 하여 가 NetworkStream 읽을 수 있는지 확인합니다. 읽을 수 없는 에서 NetworkStream 읽으려고 하면 가 InvalidOperationException표시됩니다.

참고

를 수신하는 IOException경우 속성을 검사 InnerException 속성이 로 SocketException인해 발생했는지 확인합니다. 이 경우 속성을 사용하여 ErrorCode 특정 오류 코드를 가져오고 Windows 소켓 버전 2 API 오류 코드 설명서를 참조하여 오류에 대한 자세한 설명을 참조하세요.

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

적용 대상