UdpClient Constructor ()

 
System_CAPS_noteNote

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.

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

new : unit -> UdpClient

Exception Condition
SocketException

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

This constructor creates a new UdpClient and allows the underlying service provider to assign the most appropriate local IPv4 address and port number. If this constructor is used, the UdpClient instance is set with an address family of IPv4 that cannot be changed or overwritten by a connect method call with an IPv6 target.

System_CAPS_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.

This constructor is not suitable for joining a multicast group because it does not perform socket binding. Also, it works only with IPv4 address types.

The following example demonstrates how to use the default constructor to create an instance of the UdpClient class.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: