IPGlobalProperties.GetActiveTcpListeners 方法

定義

命名空間:

System.Net.NetworkInformation

組件:

System.Net.NetworkInformation.dll

來源:

IPGlobalProperties.cs

傳回本機電腦上之網際網路通訊協定第 4 版 (IPv4) 和 IPv6 傳輸控制通訊協定 (TCP) 接聽程式的端點資訊。

public:
 abstract cli::array <System::Net::IPEndPoint ^> ^ GetActiveTcpListeners();

[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
public abstract System.Net.IPEndPoint[] GetActiveTcpListeners ();

[<System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
abstract member GetActiveTcpListeners : unit -> System.Net.IPEndPoint[]

Public MustOverride Function GetActiveTcpListeners () As IPEndPoint()

傳回

IPEndPoint[]

IPEndPoint 陣列，包含描述現用 TCP 接聽程式的物件，但如果沒有偵測到現用 TCP 接聽程式則為空陣列。

屬性

UnsupportedOSPlatformAttribute

例外狀況

NetworkInformationException

Win32 函式 GetTcpTable 失敗。

範例

下列程式代碼範例會顯示作用中 TCP 接聽程式端點資訊。

void ShowActiveTcpListeners()
{
   Console::WriteLine( "Active TCP Listeners" );
   IPGlobalProperties ^ properties = IPGlobalProperties::GetIPGlobalProperties();
   array<IPEndPoint^>^endPoints = properties->GetActiveTcpListeners();
   System::Collections::IEnumerator^ myEnum7 = endPoints->GetEnumerator();
   while ( myEnum7->MoveNext() )
   {
      IPEndPoint^ e = safe_cast<IPEndPoint^>(myEnum7->Current);
      Console::WriteLine( e );
   }
}

public static void ShowActiveTcpListeners()
{
    Console.WriteLine("Active TCP Listeners");
    IPGlobalProperties properties = IPGlobalProperties.GetIPGlobalProperties();
    IPEndPoint[] endPoints =  properties.GetActiveTcpListeners();
    foreach (IPEndPoint e in endPoints)
    {
        Console.WriteLine(e.ToString());
    }
}

備註

這個方法傳回的物件包含所有 TCP 狀態的接聽程式，但狀態除外 Listen 。

TCP 通訊協定定義於IETF RFC 793 中。 請注意，這個方法所傳回的物件會反映建立陣列時的連接。 這項資訊不會動態更新。