Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

UdpClient Constructor (IPEndPoint)

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
)

Parameters

localEP
Type: System.Net.IPEndPoint

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

ExceptionCondition
ArgumentNullException

localEP is null.

SocketException

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.

NoteNote

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);

try{
     UdpClient udpClient = new UdpClient(ipLocalEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.