TcpStatistics Class

.NET Framework (current version)

Other Versions

Provides Transmission Control Protocol (TCP) statistical data.

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

Inheritance Hierarchy

System::Object
System.Net.NetworkInformation::TcpStatistics

Syntax

C++

public ref class TcpStatistics abstract

Constructors

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

Properties

	Name	Description
	ConnectionsAccepted	Gets the number of accepted Transmission Control Protocol (TCP) connection requests.
	ConnectionsInitiated	Gets the number of Transmission Control Protocol (TCP) connection requests made by clients.
	CumulativeConnections	Specifies the total number of Transmission Control Protocol (TCP) connections established.
	CurrentConnections	Gets the number of current Transmission Control Protocol (TCP) connections.
	ErrorsReceived	Gets the number of Transmission Control Protocol (TCP) errors received.
	FailedConnectionAttempts	Gets the number of failed Transmission Control Protocol (TCP) connection attempts.
	MaximumConnections	Gets the maximum number of supported Transmission Control Protocol (TCP) connections.
	MaximumTransmissionTimeout	Gets the maximum retransmission time-out value for Transmission Control Protocol (TCP) segments.
	MinimumTransmissionTimeout	Gets the minimum retransmission time-out value for Transmission Control Protocol (TCP) segments.
	ResetConnections	Gets the number of RST packets received by Transmission Control Protocol (TCP) connections.
	ResetsSent	Gets the number of Transmission Control Protocol (TCP) segments sent with the reset flag set.
	SegmentsReceived	Gets the number of Transmission Control Protocol (TCP) segments received.
	SegmentsResent	Gets the number of Transmission Control Protocol (TCP) segments re-sent.
	SegmentsSent	Gets the number of Transmission Control Protocol (TCP) segments sent.

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 GetTcpIPv4Statistics and GetTcpIPv6Statistics methods, to give applications access to TCP traffic information.

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

Examples

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

C++

void ShowTcpStatistics( NetworkInterfaceComponent version )
{
   IPGlobalProperties ^ properties = IPGlobalProperties::GetIPGlobalProperties();
   TcpStatistics ^ tcpstat = nullptr;
   Console::WriteLine( "" );
   switch ( version )
   {
      case NetworkInterfaceComponent::IPv4:
         tcpstat = properties->GetTcpIPv4Statistics();
         Console::WriteLine( "TCP/IPv4 Statistics:" );
         break;

      case NetworkInterfaceComponent::IPv6:
         tcpstat = properties->GetTcpIPv6Statistics();
         Console::WriteLine( "TCP/IPv6 Statistics:" );
         break;

      default:
         throw gcnew ArgumentException( "version" );
         break;
   }
   Console::WriteLine( "  Minimum Transmission Timeout............. : {0}",
      tcpstat->MinimumTransmissionTimeout );
   Console::WriteLine( "  Maximum Transmission Timeout............. : {0}",
      tcpstat->MaximumTransmissionTimeout );
   Console::WriteLine( "  Connection Data:" );
   Console::WriteLine( "      Current  ............................ : {0}",
      tcpstat->CurrentConnections );
   Console::WriteLine( "      Cumulative .......................... : {0}",
      tcpstat->CumulativeConnections );
   Console::WriteLine( "      Initiated ........................... : {0}",
      tcpstat->ConnectionsInitiated );
   Console::WriteLine( "      Accepted ............................ : {0}",
      tcpstat->ConnectionsAccepted );
   Console::WriteLine( "      Failed Attempts ..................... : {0}",
      tcpstat->FailedConnectionAttempts );
   Console::WriteLine( "      Reset ............................... : {0}",
      tcpstat->ResetConnections );
   Console::WriteLine( "" );
   Console::WriteLine( "  Segment Data:" );
   Console::WriteLine( "      Received  ........................... : {0}",
      tcpstat->SegmentsReceived );
   Console::WriteLine( "      Sent ................................ : {0}",
      tcpstat->SegmentsSent );
   Console::WriteLine( "      Retransmitted ....................... : {0}",
      tcpstat->SegmentsResent );
   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.