NetworkStream.WriteAsync 메서드

정의

네임스페이스:

System.Net.Sockets

어셈블리:

System.Net.Sockets.dll

오버로드

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	읽기 전용 메모리 바이트 메모리 범위에서 비동기 작업으로 NetworkStream에 데이터를 씁니다.
WriteAsync(Byte[], Int32, Int32, CancellationToken)	지정된 범위의 바이트 배열에서 비동기 작업으로 NetworkStream에 데이터를 씁니다.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Source:

NetworkStream.cs

읽기 전용 메모리 바이트 메모리 범위에서 비동기 작업으로 NetworkStream에 데이터를 씁니다.

public override System.Threading.Tasks.ValueTask WriteAsync (ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

매개 변수

buffer

ReadOnlyMemory<Byte>

NetworkStream에 쓸 데이터를 포함하는 메모리 영역입니다.

cancellationToken

CancellationToken

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

반환

ValueTask

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

예외

InvalidOperationException

NetworkStream에서 쓰기를 지원하지 않습니다.

IOException

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

또는

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

ObjectDisposedException

NetworkStream가 닫혔습니다.

OperationCanceledException

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

설명

이 메서드는 의 모든 바이트를 buffer 네트워크에 보냅니다.

참고

속성을 호출 CanWrite 하여 이 NetworkStream 쓰기 가능한지 확인합니다. 쓸 수 없는 에 NetworkStream 쓰려고 하면 가 InvalidOperationException표시됩니다.

참고

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

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

Source:

NetworkStream.cs

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

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task WriteAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

매개 변수

buffer

Byte[]

NetworkStream에 쓸 데이터를 포함하는 바이트 배열입니다.

offset

Int32

데이터를 쓰기 시작할 buffer 내의 위치입니다.

count

Int32

NetworkStream에 쓸 바이트 수입니다.

cancellationToken

CancellationToken

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

반환

Task

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

예외

ArgumentNullException

buffer 매개 변수가 null인 경우

ArgumentOutOfRangeException

offset 매개 변수가 0보다 작은 경우

또는

offset 매개 변수가 buffer의 길이보다 큰 경우

또는

size 매개 변수가 0보다 작은 경우

또는

size 매개 변수가 buffer의 길이에서 offset 매개 변수의 값을 뺀 값보다 큰 경우

InvalidOperationException

NetworkStream에서 쓰기를 지원하지 않습니다.

IOException

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

또는

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

ObjectDisposedException

NetworkStream가 닫혔습니다.

OperationCanceledException

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

설명

이 메서드는 지정된 offset 에서 시작하고 의 콘텐츠 buffer 에서 네트워크로 바이트를 보냅니 size 다.

참고

속성을 호출 CanWrite 하여 이 NetworkStream 쓰기 가능한지 확인합니다. 쓸 수 없는 에 NetworkStream 쓰려고 하면 가 InvalidOperationException표시됩니다.

참고

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

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