UdpStatistics Class

.NET Framework (current version)

Other Versions

Provides User Datagram Protocol (UDP) statistical data.

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

Inheritance Hierarchy

System::Object
System.Net.NetworkInformation::UdpStatistics

Syntax

C++

public ref class UdpStatistics abstract

Constructors

	Name	Description
	UdpStatistics()	Initializes a new instance of the UdpStatistics class.

Properties

	Name	Description
	DatagramsReceived	Gets the number of User Datagram Protocol (UDP) datagrams that were received.
	DatagramsSent	Gets the number of User Datagram Protocol (UDP) datagrams that were sent.
	IncomingDatagramsDiscarded	Gets the number of User Datagram Protocol (UDP) datagrams that were received and discarded because of port errors.
	IncomingDatagramsWithErrors	Gets the number of User Datagram Protocol (UDP) datagrams that were received and discarded because of errors other than bad port information.
	UdpListeners	Gets the number of local endpoints that are listening for User Datagram Protocol (UDP) datagrams.

Methods

	Name	Description
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

Remarks

Instances of this class are returned by the GetUdpIPv4Statistics and GetUdpIPv6Statistics methods to give applications access to UDP traffic information.

The information in this class correlates to the management information objects described in http://www.ietf.org/rfc/rfc2013.txt.

Examples

The following code example displays the UDP statistics for the specified address family.

C++

void ShowUdpStatistics( NetworkInterfaceComponent version )
{
   IPGlobalProperties ^ properties = IPGlobalProperties::GetIPGlobalProperties();
   UdpStatistics ^ udpStat = nullptr;
   switch ( version )
   {
      case NetworkInterfaceComponent::IPv4:
         udpStat = properties->GetUdpIPv4Statistics();
         Console::WriteLine( "UDP IPv4 Statistics" );
         break;

      case NetworkInterfaceComponent::IPv6:
         udpStat = properties->GetUdpIPv6Statistics();
         Console::WriteLine( "UDP IPv6 Statistics" );
         break;

      default:
         throw gcnew ArgumentException( "version" );
         break;
   }
   Console::WriteLine( "  Datagrams Received ...................... : {0}", udpStat->DatagramsReceived );
   Console::WriteLine( "  Datagrams Sent .......................... : {0}", udpStat->DatagramsSent );
   Console::WriteLine( "  Incoming Datagrams Discarded ............ : {0}", udpStat->IncomingDatagramsDiscarded );
   Console::WriteLine( "  Incoming Datagrams With Errors .......... : {0}", udpStat->IncomingDatagramsWithErrors );
   Console::WriteLine( "  UDP Listeners ........................... : {0}", udpStat->UdpListeners );
   Console::WriteLine( "" );
}

Version Information

.NET Framework
Available since 2.0

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.