UdpClient Constructor (IPEndPoint)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Initializes a new instance of the UdpClient class and binds it to the specified local endpoint.

Namespace:   System.Net.Sockets
Assembly:  System (in System.dll)

public UdpClient(
	IPEndPoint localEP


Type: System.Net.IPEndPoint

An IPEndPoint that respresents the local endpoint to which you bind the UDP connection.

Exception Condition

localEP is null.


An error occurred when accessing the socket. See the Remarks section for more information.

This constructor creates a new UdpClient and binds it to the IPEndPoint specified by the localEP parameter. Before you call this constructor, you must create an IPEndPoint using the IP address and port number from which you intend to send and receive data. You do not need to specify a local IP address and port number for sending and receiving data. If you do not, the underlying service provider will assign the most appropriate local IP address and port number.

If this constructor is used, the UdpClient instance is set with the address family specified by the localEP parameter that cannot be changed or overwritten by a connect method call with a different address family.


If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. Once you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation in MSDN for a detailed description of the error.

The following example demonstrates how to create an instance of the UdpClient class using a local endpoint.

//Creates an instance of the UdpClient class using a local endpoint.
 IPAddress ipAddress = Dns.Resolve(Dns.GetHostName()).AddressList[0];
 IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);

     UdpClient udpClient = new UdpClient(ipLocalEndPoint);
catch (Exception e ) {

.NET Framework
Available since 1.1
Return to top