UdpClient.Send 메서드

정의

네임스페이스:

System.Net.Sockets

어셈블리:

netstandard.dll, System.Net.Sockets.dll

UDP 데이터그램을 원격 호스트로 보냅니다.

오버로드

Name	Description
Send(Byte[], Int32, String, Int32)	지정된 원격 호스트의 지정된 포트에 UDP 데이터그램을 보냅니다.
Send(ReadOnlySpan<Byte>, String, Int32)	지정된 원격 호스트의 지정된 포트에 UDP 데이터그램을 보냅니다.
Send(Byte[], Int32, IPEndPoint)	지정된 원격 엔드포인트의 호스트에 UDP 데이터그램을 보냅니다.
Send(Byte[], Int32)	UDP 데이터그램을 원격 호스트로 보냅니다.
Send(ReadOnlySpan<Byte>)	UDP 데이터그램을 원격 호스트로 보냅니다.
Send(ReadOnlySpan<Byte>, IPEndPoint)	지정된 원격 엔드포인트의 호스트에 UDP 데이터그램을 보냅니다.

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

Source:

UDPClient.cs

지정된 원격 호스트의 지정된 포트에 UDP 데이터그램을 보냅니다.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes, System::String ^ hostname, int port);

public int Send(byte[] dgram, int bytes, string? hostname, int port);

member this.Send : byte[] * int * string * int -> int

Public Function Send (dgram As Byte(), bytes As Integer, hostname As String, port As Integer) As Integer

매개 변수

dgram

Byte[]

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

bytes

Int32

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

hostname

String

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

port

Int32

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

반환

Int32

보낸 바이트 수입니다.

예외

ArgumentNullException

dgram은 null입니다.

InvalidOperationException

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

ObjectDisposedException

UdpClient 닫혀 있습니다.

SocketException

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

예제

다음 예제에서는 메서드를 보여 줍니다 Send . 이 예제에서는 호스트 이름과 포트 번호를 사용하여 대상 호스트를 식별합니다.

UdpClient udpClient = new UdpClient();

Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
    udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000);
}
catch ( Exception e ){
    Console.WriteLine(e.ToString());	
}

Dim udpClient As New UdpClient()

Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
   udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

설명

메서드는 Send 데이터그램을 및 port 매개 변수로 지정된 값으로 hostname 보내고 성공적으로 전송된 바이트 수를 반환합니다. 매개 변수 값에 대해 "255.255.255.255"를 지정하여 데이터그램을 기본 브로드캐스트 주소로 hostname 보낼 수 있습니다.

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

메모

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

추가 정보

• Broadcast
• Connect(String, Int32)
• Socket

Send(ReadOnlySpan<Byte>, String, Int32)

Source:

UDPClient.cs

지정된 원격 호스트의 지정된 포트에 UDP 데이터그램을 보냅니다.

public:
 int Send(ReadOnlySpan<System::Byte> datagram, System::String ^ hostname, int port);

public int Send(ReadOnlySpan<byte> datagram, string? hostname, int port);

member this.Send : ReadOnlySpan<byte> * string * int -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte), hostname As String, port As Integer) As Integer

매개 변수

datagram

ReadOnlySpan<Byte>

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

hostname

String

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

port

Int32

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

반환

Int32

보낸 바이트 수입니다.

예외

InvalidOperationException

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

ObjectDisposedException

UdpClient 닫혀 있습니다.

SocketException

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

Send(Byte[], Int32, IPEndPoint)

Source:

UDPClient.cs

지정된 원격 엔드포인트의 호스트에 UDP 데이터그램을 보냅니다.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes, System::Net::IPEndPoint ^ endPoint);

public int Send(byte[] dgram, int bytes, System.Net.IPEndPoint? endPoint);

member this.Send : byte[] * int * System.Net.IPEndPoint -> int

Public Function Send (dgram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Integer

매개 변수

dgram

Byte[]

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

bytes

Int32

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

endPoint

IPEndPoint

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

반환

Int32

보낸 바이트 수입니다.

예외

ArgumentNullException

dgram은 null입니다.

InvalidOperationException

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

ObjectDisposedException

UdpClient 가 닫혀 있습니다.

SocketException

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

예제

다음 예제에서는 메서드를 보여 줍니다 Send . 이 예제에서는 IPEndPoint 대상 호스트를 지정하는 데 사용합니다.

UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);	

Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there?");
try{
    udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint);
}
catch ( Exception e ){
    Console.WriteLine(e.ToString());	
}

Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)

Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there?")
Try
   udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

설명

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

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

메모

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

추가 정보

• Broadcast
• Connect(String, Int32)
• Socket
• IPEndPoint

Send(Byte[], Int32)

Source:

UDPClient.cs

UDP 데이터그램을 원격 호스트로 보냅니다.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes);

public int Send(byte[] dgram, int bytes);

member this.Send : byte[] * int -> int

Public Function Send (dgram As Byte(), bytes As Integer) As Integer

매개 변수

dgram

Byte[]

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

bytes

Int32

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

반환

Int32

보낸 바이트 수입니다.

예외

ArgumentNullException

dgram은 null입니다.

InvalidOperationException

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

ObjectDisposedException

UdpClient 닫혀 있습니다.

SocketException

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

예제

다음 예제에서는 메서드를 보여 줍니다 Send . 이 오버로드를 사용하기 전에 기본 원격 호스트를 설정해야 합니다.

UdpClient udpClient = new UdpClient("www.contoso.com", 11000);
Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
    udpClient.Send(sendBytes, sendBytes.Length);
}
catch ( Exception e ){
    Console.WriteLine( e.ToString());
}

Dim udpClient As New UdpClient("www.contoso.com", 11000)
Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
   udpClient.Send(sendBytes, sendBytes.Length)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

설명

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

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

추가 정보

• Connect(String, Int32)

Send(ReadOnlySpan<Byte>)

Source:

UDPClient.cs

UDP 데이터그램을 원격 호스트로 보냅니다.

public:
 int Send(ReadOnlySpan<System::Byte> datagram);

public int Send(ReadOnlySpan<byte> datagram);

member this.Send : ReadOnlySpan<byte> -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte)) As Integer

매개 변수

datagram

ReadOnlySpan<Byte>

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

반환

Int32

보낸 바이트 수입니다.

예외

InvalidOperationException

UdpClient 기본 원격 호스트를 설정하지 않았습니다.

ObjectDisposedException

UdpClient 닫혀 있습니다.

SocketException

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

Send(ReadOnlySpan<Byte>, IPEndPoint)

Source:

UDPClient.cs

지정된 원격 엔드포인트의 호스트에 UDP 데이터그램을 보냅니다.

public:
 int Send(ReadOnlySpan<System::Byte> datagram, System::Net::IPEndPoint ^ endPoint);

public int Send(ReadOnlySpan<byte> datagram, System.Net.IPEndPoint? endPoint);

member this.Send : ReadOnlySpan<byte> * System.Net.IPEndPoint -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte), endPoint As IPEndPoint) As Integer

매개 변수

datagram

ReadOnlySpan<Byte>

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

endPoint

IPEndPoint

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

반환

Int32

보낸 바이트 수입니다.

예외

InvalidOperationException

UdpClient 가 이미 기본 원격 호스트를 설정했으며 endPointnull.

ObjectDisposedException

UdpClient 가 닫혀 있습니다.

SocketException

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