語言

TcpListener.Start 方法

定義

開始監聽有沒有連線請求。

多載

名稱 Description
Start()

開始監聽有沒有連線請求。

Start(Int32)

開始監聽有最多待處理連線數量的來電連線請求。

Start()

來源:
TCPListener.cs
來源:
TCPListener.cs
來源:
TCPListener.cs
來源:
TCPListener.cs
來源:
TCPListener.cs

開始監聽有沒有連線請求。

public:
 void Start();
public void Start();
member this.Start : unit -> unit
Public Sub Start ()

例外狀況

利用該 ErrorCode 屬性取得特定的錯誤代碼。 取得這些程式碼後,你可以參考 Windows Sockets 版本 2 的 API 錯誤代碼 文件,以獲得錯誤的詳細說明。

範例

以下程式碼範例示範如何 Start 用來監聽用戶端連線嘗試。

public static void DoStart(TcpListener t, int backlog)
{
    // Start listening for client connections with the
    // specified backlog.
    t.Start(backlog);
    Console.WriteLine("started listening");
}
Public Shared Sub DoStart(t As TcpListener, backlog As Integer)
   ' Start listening for client connections with the 
   ' specified backlog.
   t.Start(backlog)
   Console.WriteLine("started listening")
End Sub

備註

該 Start 方法初始化底層 Socket,將其綁定到本地端點,並監聽入侵連線嘗試。 如果收到連線請求, Start 該方法會排隊並持續監聽其他請求,直到你呼叫該 Stop 方法為止。 如果 TcpListener 在已經排滿最大連線數後才收到連線請求,它會向用戶端拋出 a SocketException 。

要從輸入連線佇列中移除連線,請使用 該AcceptTcpClient方法或該方法。AcceptSocket 這個 AcceptTcpClient 方法會從佇列中移除一個連線,並回傳 TcpClient 一個可以用來傳送和接收資料的連線。 這個 AcceptSocket 方法會回傳一個 Socket ,你可以用來做同樣的事。 如果你的應用程式只需要同步 I/O,請使用 AcceptTcpClient。 若要更詳細的行為控制,請使用 AcceptSocket。 這兩種方法都會阻塞,直到佇列中有連線請求。

用這個 Stop 方法關閉並 TcpListener 停止聆聽。 你有責任分別關閉你已接受的連線。

Note

當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 欲了解更多資訊,請參閱.NET框架中的網絡追蹤。

另請參閱

適用於

Start(Int32)

來源:
TCPListener.cs
來源:
TCPListener.cs
來源:
TCPListener.cs
來源:
TCPListener.cs
來源:
TCPListener.cs

開始監聽有最多待處理連線數量的來電連線請求。

public:
 void Start(int backlog);
public void Start(int backlog);
member this.Start : int -> unit
Public Sub Start (backlog As Integer)

參數

backlog
Int32

待處理連線隊列的最大長度。

例外狀況

存取插槽時發生錯誤。

backlog參數小於零或超過最大允許連線數。

標的 Socket 資產為零。

範例

以下程式碼範例示範如何 Start 用來監聽用戶端連線嘗試。

public static void DoStart(TcpListener t, int backlog)
{
    // Start listening for client connections with the
    // specified backlog.
    t.Start(backlog);
    Console.WriteLine("started listening");
}
Public Shared Sub DoStart(t As TcpListener, backlog As Integer)
   ' Start listening for client connections with the 
   ' specified backlog.
   t.Start(backlog)
   Console.WriteLine("started listening")
End Sub

備註

該 Start 方法初始化底層 Socket,將其綁定到本地端點,並監聽入侵連線嘗試。 如果收到連線請求, Start 會將該請求排隊並持續監聽其他請求,直到你呼叫該 Stop 方法為止。 如果 TcpListener 在已經排滿最大連線數後才收到連線請求,它會拋出 a SocketException 給用戶端。

要從輸入連線佇列中移除連線,請使用 該AcceptTcpClient方法或該方法。AcceptSocket 這個 AcceptTcpClient 方法會從佇列中移除一個連線,並回傳 TcpClient 一個可以用來傳送和接收資料的連線。 這個 AcceptSocket 方法會回傳一個 Socket ,你可以用來做同樣的事。 如果你的應用程式只需要同步輸入輸出,請使用 AcceptTcpClient. 若想更詳細地控制行為,請使用 AcceptSocket 方法。 這兩種方法都會阻塞,直到佇列中有連線請求。

用這個 Stop 方法關閉並 TcpListener 停止聆聽。 你有責任分別關閉你已接受的連線。

Note

請使用此 SocketException.ErrorCode 特性取得特定的錯誤代碼,並參考 Windows Sockets 版本 2 的 API 錯誤代碼 文件以獲得錯誤的詳細描述。

Note

當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 欲了解更多資訊,請參閱.NET框架中的網絡追蹤。

另請參閱

適用於