IPGlobalProperties.GetActiveUdpListeners Method

Reference

Definition

Namespace:: System.Net.NetworkInformation

Assembly:: System.Net.NetworkInformation.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: IPGlobalProperties.cs

Source:: IPGlobalProperties.cs

Source:: IPGlobalProperties.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns information about the Internet Protocol version 4 (IPv4) and IPv6 User Datagram Protocol (UDP) listeners on the local computer.

public:
 abstract cli::array <System::Net::IPEndPoint ^> ^ GetActiveUdpListeners();

public abstract System.Net.IPEndPoint[] GetActiveUdpListeners ();

[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
public abstract System.Net.IPEndPoint[] GetActiveUdpListeners ();

abstract member GetActiveUdpListeners : unit -> System.Net.IPEndPoint[]

[<System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
abstract member GetActiveUdpListeners : unit -> System.Net.IPEndPoint[]

Public MustOverride Function GetActiveUdpListeners () As IPEndPoint()

Returns

IPEndPoint[]

An IPEndPoint array that contains objects that describe the UDP listeners, or an empty array if no UDP listeners are detected.

Attributes: UnsupportedOSPlatformAttribute

Exceptions

NetworkInformationException

The call to the Win32 function GetUdpTable failed.

Examples

The following example displays the active UDP listeners.

void ShowActiveUdpListeners()
{
   Console::WriteLine( "Active UDP Listeners" );
   IPGlobalProperties ^ properties = IPGlobalProperties::GetIPGlobalProperties();
   array<IPEndPoint^>^endPoints = properties->GetActiveUdpListeners();
   System::Collections::IEnumerator^ myEnum8 = endPoints->GetEnumerator();
   while ( myEnum8->MoveNext() )
   {
      IPEndPoint^ e = safe_cast<IPEndPoint^>(myEnum8->Current);
      Console::WriteLine( e );
   }
}

public static void ShowActiveUdpListeners()
{
    Console.WriteLine("Active UDP Listeners");
    IPGlobalProperties properties = IPGlobalProperties.GetIPGlobalProperties();
    IPEndPoint[] endPoints =  properties.GetActiveUdpListeners();
    foreach (IPEndPoint e in endPoints)
    {
        Console.WriteLine(e.ToString());
    }
}

Remarks

UDP is a connectionless transport layer protocol that is responsible for sending and receiving datagrams. It is defined in IETF RFC 768.

A UDP listener is an open socket that waits for and receives UDP datagrams. Because UDP is a connectionless protocol, the listener does not maintain a connection to a remote endpoint.

Applies to