UdpClient.Receive Method

Receives a datagram from the UdpClient.

Syntax

public byte[] Receive (ref System.Net.EndPoint remoteEP);

Parameters

Returns

A byte array containing the data received.

Exceptions

Remarks

The Receive method reads datagrams from the UdpClient. If no datagram is available, the Receive method blocks until a datagram is received.

The remoteEP parameter is an output parameter that is updated with the IPEndPoint of the sender.

You can use the ReceiveAsync method to receive datagrams asynchronously.

Example

The following example demonstrates how to create a UdpClient, bind it to a local endpoint, and then receive data.

using System;
using System.Net;
using System.Net.Sockets;
using System.Text;

public class UdpReceiver
{
    public static void Main(string[] args)
    {
        int port = 11000;
        UdpClient udpListener = null;
        try
        {
            // Create a UdpClient to listen on a specific port.
            udpListener = new UdpClient(port);

            Console.WriteLine($"Listening on port {port}...");

            // Create an IPEndPoint to store the sender's endpoint.
            IPEndPoint remoteEP = new IPEndPoint(IPAddress.Any, 0);

            // Listen for incoming datagrams.
            while (true)
            {
                // Receive data and the sender's endpoint.
                byte[] receivedBytes = udpListener.Receive(ref remoteEP);

                // Convert the bytes to a string.
                string receivedData = Encoding.ASCII.GetString(receivedBytes);

                Console.WriteLine($"Received '{receivedData}' from {remoteEP.Address}:{remoteEP.Port}");
            }
        }
        catch (Exception e)
        {
            Console.WriteLine($"An error occurred: {e.Message}");
        }
        finally
        {
            udpListener?.Close();
        }
    }
}