IPGlobalProperties.GetIPv4GlobalStatistics メソッド

.NET Framework クラス ライブラリ リファレンス

IPGlobalProperties.GetIPv4GlobalStatistics メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ローカル コンピュータのインターネット プロトコル Version 4 (IPv4) 統計データを提供します。

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Function
 GetIPv4GlobalStatistics As IPGlobalStatistics

Visual Basic (使用法)

Dim instance As IPGlobalProperties
Dim returnValue As IPGlobalStatistics

returnValue = instance.GetIPv4GlobalStatistics

C#

public abstract IPGlobalStatistics GetIPv4GlobalStatistics ()

C++

public:
virtual IPGlobalStatistics^ GetIPv4GlobalStatistics () abstract

J#

public abstract IPGlobalStatistics GetIPv4GlobalStatistics ()

JScript

public abstract function GetIPv4GlobalStatistics
 () : IPGlobalStatistics

戻り値
ローカル コンピュータの IPv4 トラフィック統計情報を提供する IPGlobalStatistics オブジェクト。

例外

例外の種類	条件
NetworkInformationException	Win32 関数 GetIpStatistics の呼び出しが失敗しました。

解説

IPv4 は、送信元のコンピュータから送信先にデータ パケットをルーティングするネットワーク層プロトコルです。

アプリケーションが利用できる IP トラフィック統計情報の詳細については、IPGlobalStatistics クラスのドキュメントを参照してください。このメソッドによって返されるオブジェクトは、IPGlobalStatistics オブジェクトが作成される時点の統計が反映されます。この情報は動的には更新されません。

使用例

ローカル コンピュータの IP 統計情報を表示するコード例を次に示します。

C#

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("");
}

.NET Framework のセキュリティ

• NetworkInformationPermission  (ネットワーク情報を読み取るために必要なアクセス許可)Read (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IPGlobalProperties クラス
IPGlobalProperties メンバ
System.Net.NetworkInformation 名前空間