UdpClient.SendAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. 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)
- 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)매개 변수
- 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)매개 변수
- 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)매개 변수
- 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가 닫혔습니다.
소켓에 액세스할 때 오류가 발생했습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
적용 대상
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기