UdpClient.SendAsync 메서드

참조

정의

네임스페이스:: System.Net.Sockets

어셈블리:: System.Net.Sockets.dll

어셈블리:: System.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.

오버로드

SendAsync(Byte[], Int32)	UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.
SendAsync(ReadOnlyMemory<Byte>, CancellationToken)	UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.
SendAsync(Byte[], Int32, IPEndPoint)	UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.
SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)	UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.
SendAsync(Byte[], Int32, String, Int32)	UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.
SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)	UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.

SendAsync(Byte[], Int32)

UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes);

member this.SendAsync : byte[] * int -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer) As Task(Of Integer)

매개 변수

datagram: Byte[]

보내려는 UDP 데이터그램을 지정하는 형식 Byte 의 배열이며, 바이트 배열로 표시됩니다.

bytes: Int32

데이터그램의 바이트 수입니다.

반환

Task<Int32>

Task<TResult>를 반환합니다.

예외

ArgumentNullException

dgram이(가) null인 경우

InvalidOperationException

UdpClient 에서는 기본 원격 호스트를 이미 설정한 경우

ObjectDisposedException

UdpClient가 닫혔습니다.

SocketException

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

설명

이 오버로드는 메서드에 설정된 원격 호스트로 데이터그램을 Connect 보냅니다. 이 오버로드를 호출하기 전에 호출 Connect 하지 않으면 메서드가 을 throw합니다 SocketException. 수신되는 SocketException경우 특정 오류 코드를 가져오는 데 사용합니다 SocketException.ErrorCode . 이 코드를 가져온 후에는 Windows Sockets 버전 2 API 오류 코드 설명서를 참조하여 오류에 대한 자세한 설명을 확인할 수 있습니다.

다른 원격 호스트에 데이터그램을 보내려면 메서드를 Connect 호출하고 원하는 원격 호스트를 지정해야 합니다. 다른 SendAsync 메서드 오버로드 중 하나를 사용하여 브로드캐스트 주소로 데이터그램을 보냅니다.

적용 대상

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

매개 변수

datagram: ReadOnlyMemory<Byte>

ReadOnlyMemory<T> 보낼 UDP 데이터그램을 지정하는 형식 Byte 입니다.

cancellationToken: CancellationToken

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

반환

ValueTask<Int32>

비동기 보내기 작업을 나타내는 A ValueTask<TResult> 입니다. Result 속성의 값에는 전송된 바이트 수가 포함됩니다.

예외

ObjectDisposedException

UdpClient가 닫혔습니다.

SocketException

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

적용 대상

SendAsync(Byte[], Int32, IPEndPoint)

UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::Net::IPEndPoint ^ endPoint);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, System.Net.IPEndPoint? endPoint);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, System.Net.IPEndPoint endPoint);

member this.SendAsync : byte[] * int * System.Net.IPEndPoint -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Task(Of Integer)

매개 변수

datagram: Byte[]

보내려는 UDP 데이터그램을 지정하는 형식 Byte 의 배열이며, 바이트 배열로 표시됩니다.

bytes: Int32

데이터그램의 바이트 수입니다.

endPoint: IPEndPoint

데이터그램을 보낼 호스트 및 포트를 나타내는 IPEndPoint 입니다.

반환

Task<Int32>

Task<TResult>를 반환합니다.

예외

ArgumentNullException

dgram이(가) null인 경우

InvalidOperationException

UdpClient 에서 기본 원격 호스트를 이미 설정했습니다.

ObjectDisposedException

UdpClient가 닫혀 있습니다.

SocketException

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

설명

이 메서드는 지정된 엔드포인트에 데이터그램을 보냅니다. 이 오버로드를 호출하기 전에 먼저 데이터그램이 배달될 원격 호스트의 IP 주소 및 포트 번호를 사용하여 만들어야 IPEndPoint 합니다. 의 속성을 IPEndPoint지정하여 기본 브로드캐스트 주소 255.255.255.255로 데이터그램을 SocketOptionName.Broadcast Address 보낼 수 있습니다. 이 메서드를 만든 후 이 IPEndPoint메서드에 매개 변수로 endPoint 전달합니다.

다른 브로드캐스트 주소로 데이터그램을 보내려면 이 메서드를 Socket사용하여 Client 기본 주소를 가져오고 소켓 옵션을 SocketOptionName.Broadcast로 설정합니다. 클래스를 사용하여 Socket 되돌릴 수도 있습니다.

경고

메서드를 사용하여 endPoint 원격 호스트를 이미 설정한 경우 이 메서드에 매개 변수를 Connect 제공하지 마세요. 이 경우 이 메서드는 SocketException. 수신되는 SocketException경우 특정 오류 코드를 가져오는 데 사용합니다 SocketException.ErrorCode . 이 코드를 가져온 후에는 Windows Sockets 버전 2 API 오류 코드 설명서를 참조하여 오류에 대한 자세한 설명을 확인할 수 있습니다.

적용 대상

SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)

UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, System.Net.IPEndPoint? endPoint, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), endPoint As IPEndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

매개 변수

datagram: ReadOnlyMemory<Byte>

ReadOnlyMemory<T> 보낼 UDP 데이터그램을 지정하는 형식 Byte 입니다.

endPoint: IPEndPoint

데이터그램을 보낼 호스트 및 포트를 나타내는 IPEndPoint 입니다.

cancellationToken: CancellationToken

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

반환

ValueTask<Int32>

비동기 보내기 작업을 나타내는 A ValueTask<TResult> 입니다. Result 속성의 값에는 전송된 바이트 수가 포함됩니다.

예외

InvalidOperationException

UdpClient 가 이미 기본 원격 호스트를 설정했으며 endPoint 그렇지 않습니다 null.

ObjectDisposedException

UdpClient가 닫혔습니다.

SocketException

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

적용 대상

SendAsync(Byte[], Int32, String, Int32)

UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::String ^ hostname, int port);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, string? hostname, int port);

public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, string hostname, int port);

member this.SendAsync : byte[] * int * string * int -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer, hostname As String, port As Integer) As Task(Of Integer)

매개 변수

datagram: Byte[]

보내려는 UDP 데이터그램을 지정하는 형식 Byte 의 배열이며, 바이트 배열로 표시됩니다.

bytes: Int32

데이터그램의 바이트 수입니다.

hostname: String

데이터그램을 보낼 원격 호스트의 이름입니다.

port: Int32

통신하려는 원격 포트 번호입니다.

반환

Task<Int32>

Task<TResult>를 반환합니다.

예외

ArgumentNullException

dgram이(가) null인 경우

InvalidOperationException

UdpClient 에서는 기본 원격 호스트를 이미 설정한 경우

ObjectDisposedException

UdpClient가 닫혔습니다.

SocketException

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

설명

이 메서드는 데이터그램을 매개 변수 및 port 매개 변수로 지정된 값으로 hostname 보냅니다. 매개 변수 값에 대해 "255.255.255.255"를 지정하여 데이터그램을 기본 브로드캐스트 주소로 hostname 보낼 수 있습니다.

경고

메서드를 사용하여 원격 호스트를 이미 설정한 경우 이 메서드에 호스트 Connect 이름 또는 포트 번호를 제공하지 마세요. 이 경우 이 메서드는 SocketException. 수신되는 SocketException경우 특정 오류 코드를 가져오는 데 사용합니다 SocketException.ErrorCode . 이 코드를 가져온 후에는 Windows Sockets 버전 2 API 오류 코드 설명서를 참조하여 오류에 대한 자세한 설명을 확인할 수 있습니다.

적용 대상

SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)

UDP 데이터그램을 원격 호스트에 비동기적으로 보냅니다.

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, string? hostname, int port, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), hostname As String, port As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)