IPGlobalProperties.GetActiveTcpConnections メソッドとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

IPGlobalProperties.GetActiveTcpConnections メソッド

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

ローカルコンピュータ上のインターネットプロトコル Version 4 (IPv4: Internet Protocol version 4) 伝送制御プロトコル (TCP: Transmission Control Protocol) 接続に関する情報を返します。

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

Visual Basic (宣言)

Public MustOverride Function
 GetActiveTcpConnections As TcpConnectionInformation()

Visual Basic (使用法)

Dim instance As IPGlobalProperties
Dim returnValue As TcpConnectionInformation()

returnValue = instance.GetActiveTcpConnections

public abstract TcpConnectionInformation[] GetActiveTcpConnections
 ()

C++

public:
virtual array<TcpConnectionInformation^>^ GetActiveTcpConnections () abstract

public abstract TcpConnectionInformation[] GetActiveTcpConnections
 ()

JScript

public abstract function GetActiveTcpConnections
 () : TcpConnectionInformation[]

戻り値
アクティブな TCP 接続が記述されたオブジェクトを格納している TcpConnectionInformation 配列。アクティブな TCP 接続が検出されない場合は空の配列。

例外

例外の種類	条件
NetworkInformationException	Win32 関数 GetTcpTable が失敗しました。

解説

このメソッドによって返されるオブジェクトには、Listen 状態を除くすべての TCP 状態にある接続が含まれます。State を呼び出して、接続の状態をチェックできます。

TCP プロトコルは IETF RFC 793 で定義されています。このメソッドによって返されるオブジェクトには、その配列が作成される時点の接続が反映されます。この情報は動的には更新されません。

使用例

アクティブな TCP 接続のエンドポイント情報を表示するコード例を次に示します。

public static void ShowActiveTcpConnections()
{
           Console.WriteLine("Active TCP Connections");
           IPGlobalProperties properties = IPGlobalProperties.GetIPGlobalProperties();
           TcpConnectionInformation[] connections = properties.GetActiveTcpConnections();
 
           foreach (TcpConnectionInformation c in
 connections)
           {
               Console.WriteLine("{0} <==> {1}", 
                   c.LocalEndPoint.ToString(), 
                   c.RemoteEndPoint.ToString());
           }
}