다음을 통해 공유


UdpClient.SendAsync 메서드

정의

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)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

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<TResult>를 반환합니다.

예외

dgram이(가) null인 경우

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

UdpClient가 닫혔습니다.

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

설명

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

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

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

적용 대상

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

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

예외

UdpClient가 닫혔습니다.

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

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

적용 대상

SendAsync(Byte[], Int32, IPEndPoint)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

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<TResult>를 반환합니다.

예외

dgram이(가) null인 경우

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

UdpClient가 닫혀 있습니다.

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

설명

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

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

경고

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

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

적용 대상

SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

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

예외

UdpClient 은 이미 기본 원격 호스트를 설정했으며 가 endPoint 아닙니다 null.

UdpClient가 닫혔습니다.

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

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

적용 대상

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

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

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<TResult>를 반환합니다.

예외

dgram이(가) null인 경우

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

UdpClient가 닫혔습니다.

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

설명

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

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

경고

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

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

적용 대상

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

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

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)

매개 변수

datagram
ReadOnlyMemory<Byte>

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

hostname
String

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

port
Int32

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

cancellationToken
CancellationToken

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

반환

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

예외

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

UdpClient가 닫혔습니다.

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

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

적용 대상