IPGlobalStatistics Class
Collapse the table of content
Expand the table of content

IPGlobalStatistics Class

 

Provides Internet Protocol (IP) statistical data.

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

System.Object
  System.Net.NetworkInformation.IPGlobalStatistics

public abstract class IPGlobalStatistics

NameDescription
System_CAPS_protmethodIPGlobalStatistics()

Initializes a new instance of the IPGlobalStatistics class.

NameDescription
System_CAPS_pubpropertyDefaultTtl

Gets the default time-to-live (TTL) value for Internet Protocol (IP) packets.

System_CAPS_pubpropertyForwardingEnabled

Gets a Boolean value that specifies whether Internet Protocol (IP) packet forwarding is enabled.

System_CAPS_pubpropertyNumberOfInterfaces

Gets the number of network interfaces.

System_CAPS_pubpropertyNumberOfIPAddresses

Gets the number of Internet Protocol (IP) addresses assigned to the local computer.

System_CAPS_pubpropertyNumberOfRoutes

Gets the number of routes in the Internet Protocol (IP) routing table.

System_CAPS_pubpropertyOutputPacketRequests

Gets the number of outbound Internet Protocol (IP) packets.

System_CAPS_pubpropertyOutputPacketRoutingDiscards

Gets the number of routes that have been discarded from the routing table.

System_CAPS_pubpropertyOutputPacketsDiscarded

Gets the number of transmitted Internet Protocol (IP) packets that have been discarded.

System_CAPS_pubpropertyOutputPacketsWithNoRoute

Gets the number of Internet Protocol (IP) packets for which the local computer could not determine a route to the destination address.

System_CAPS_pubpropertyPacketFragmentFailures

Gets the number of Internet Protocol (IP) packets that could not be fragmented.

System_CAPS_pubpropertyPacketReassembliesRequired

Gets the number of Internet Protocol (IP) packets that required reassembly.

System_CAPS_pubpropertyPacketReassemblyFailures

Gets the number of Internet Protocol (IP) packets that were not successfully reassembled.

System_CAPS_pubpropertyPacketReassemblyTimeout

Gets the maximum amount of time within which all fragments of an Internet Protocol (IP) packet must arrive.

System_CAPS_pubpropertyPacketsFragmented

Gets the number of Internet Protocol (IP) packets fragmented.

System_CAPS_pubpropertyPacketsReassembled

Gets the number of Internet Protocol (IP) packets reassembled.

System_CAPS_pubpropertyReceivedPackets

Gets the number of Internet Protocol (IP) packets received.

System_CAPS_pubpropertyReceivedPacketsDelivered

Gets the number of Internet Protocol (IP) packets delivered.

System_CAPS_pubpropertyReceivedPacketsDiscarded

Gets the number of Internet Protocol (IP) packets that have been received and discarded.

System_CAPS_pubpropertyReceivedPacketsForwarded

Gets the number of Internet Protocol (IP) packets forwarded.

System_CAPS_pubpropertyReceivedPacketsWithAddressErrors

Gets the number of Internet Protocol (IP) packets with address errors that were received.

System_CAPS_pubpropertyReceivedPacketsWithHeadersErrors

Gets the number of Internet Protocol (IP) packets with header errors that were received.

System_CAPS_pubpropertyReceivedPacketsWithUnknownProtocol

Gets the number of Internet Protocol (IP) packets received on the local machine with an unknown protocol in the header.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

This class is used by the GetIPv4GlobalStatistics and GetIPv6GlobalStatistics methods to return IP traffic information.

The Internet protocol is used to move IP packets from a source computer to a destination computer. IP also handles dividing a packet that is too large into multiple packets that are small enough for transport, in a process known as fragmentation.

The properties in this class correlate to the Management Information Base objects for IP defined in IETF RFC 2011.

The following code code example displays IP statistics.

public static void ShowIPStatistics(NetworkInterfaceComponent version)
{
    IPGlobalProperties properties = IPGlobalProperties.GetIPGlobalProperties();
    IPGlobalStatistics ipstat = null;
    switch (version)
    {
        case NetworkInterfaceComponent.IPv4:
             ipstat = properties.GetIPv4GlobalStatistics();
           Console.WriteLine("{0}IPv4 Statistics ",Environment.NewLine);
            break;
        case NetworkInterfaceComponent.IPv6:
            ipstat = properties.GetIPv4GlobalStatistics();
            Console.WriteLine("{0}IPv6 Statistics ",Environment.NewLine);
            break;
        default:
            throw new ArgumentException("version");
        //    break;
    }
    Console.WriteLine("  Forwarding enabled ...................... : {0}", 
        ipstat.ForwardingEnabled);
    Console.WriteLine("  Interfaces .............................. : {0}", 
        ipstat.NumberOfInterfaces);
    Console.WriteLine("  IP addresses ............................ : {0}", 
        ipstat.NumberOfIPAddresses);
    Console.WriteLine("  Routes .................................. : {0}", 
        ipstat.NumberOfRoutes);
    Console.WriteLine("  Default TTL ............................. : {0}", 
        ipstat.DefaultTtl);
    Console.WriteLine("");    
    Console.WriteLine("  Inbound Packet Data:");
    Console.WriteLine("      Received ............................ : {0}", 
        ipstat.ReceivedPackets);
    Console.WriteLine("      Forwarded ........................... : {0}", 
        ipstat.ReceivedPacketsForwarded);
    Console.WriteLine("      Delivered ........................... : {0}", 
        ipstat.ReceivedPacketsDelivered);
    Console.WriteLine("      Discarded ........................... : {0}", 
        ipstat.ReceivedPacketsDiscarded);
    Console.WriteLine("      Header Errors ....................... : {0}", 
        ipstat.ReceivedPacketsWithHeadersErrors);
    Console.WriteLine("      Address Errors ...................... : {0}", 
        ipstat.ReceivedPacketsWithAddressErrors);
    Console.WriteLine("      Unknown Protocol Errors ............. : {0}", 
        ipstat.ReceivedPacketsWithUnknownProtocol);
    Console.WriteLine("");    
    Console.WriteLine("  Outbound Packet Data:");
    Console.WriteLine("      Requested ........................... : {0}", 
         ipstat.OutputPacketRequests);
    Console.WriteLine("      Discarded ........................... : {0}", 
        ipstat.OutputPacketsDiscarded);
    Console.WriteLine("      No Routing Discards ................. : {0}", 
        ipstat.OutputPacketsWithNoRoute);
    Console.WriteLine("      Routing Entry Discards .............. : {0}", 
        ipstat.OutputPacketRoutingDiscards);
    Console.WriteLine("");    
    Console.WriteLine("  Reassembly Data:");
    Console.WriteLine("      Reassembly Timeout .................. : {0}", 
        ipstat.PacketReassemblyTimeout);
    Console.WriteLine("      Reassemblies Required ............... : {0}", 
        ipstat.PacketReassembliesRequired);
    Console.WriteLine("      Packets Reassembled ................. : {0}", 
        ipstat.PacketsReassembled);
    Console.WriteLine("      Packets Fragmented .................. : {0}", 
        ipstat.PacketsFragmented);
    Console.WriteLine("      Fragment Failures ................... : {0}", 
        ipstat.PacketFragmentFailures);
    Console.WriteLine("");
}

Universal Windows Platform
Available since 10
.NET Framework
Available since 2.0

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

Return to top
Show:
© 2016 Microsoft