TcpListener.Start 方法

定義

命名空間:

System.Net.Sockets

組件:

System.Net.Sockets.dll

啟動對輸入連接要求的接聽。

多載

Start()	啟動對輸入連接要求的接聽。
Start(Int32)	啟動對含有最大數目暫止連接之連入連接要求的接聽。

Start()

來源:

TCPListener.cs

啟動對輸入連接要求的接聽。

public:
 void Start();

public void Start ();

member this.Start : unit -> unit

Public Sub Start ()

例外狀況

SocketException

使用 ErrorCode 屬性取得特定錯誤碼。 一旦取得這個錯誤碼，您就可以參閱 Windows Sockets 第 2 版 API 錯誤碼文件，以取得錯誤的詳細描述。

範例

下列程式代碼範例示範如何使用 Start 接聽傳入用戶端連線嘗試。

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }

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 連線已排入佇列的連線數目上限之後收到連線要求，則會在用戶端上擲回 SocketException 。

若要從傳入連接佇列中移除連線，請使用 AcceptTcpClient 方法或 AcceptSocket 方法。 方法 AcceptTcpClient 會從佇列中移除連線，並傳回 TcpClient 可用來傳送和接收資料的 。 方法 AcceptSocket 會傳回 Socket 可用來執行相同動作的 。 如果您的應用程式只需要同步 I/O，請使用 AcceptTcpClient。 如需更詳細的行為控制，請使用 AcceptSocket。 這兩種方法都會封鎖，直到佇列中有連線要求為止。

Stop使用方法來關閉 TcpListener 並停止接聽。 您必須負責個別關閉已接受的連線。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

另請參閱

• Listen(Int32)
• Bind(EndPoint)
• AcceptTcpClient()
• Stop()

Start(Int32)

來源:

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

暫止連接佇列的最大長度。

例外狀況

SocketException

存取通訊端時發生錯誤。

ArgumentOutOfRangeException

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

InvalidOperationException

基礎 Socket 為 null。

範例

下列程式代碼範例示範如何使用 Start 接聽傳入用戶端連線嘗試。

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }

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 連線要求已排入佇列之後收到連線要求，則會在用戶端上擲回 SocketException 的連線數目上限。

若要從傳入連接佇列中移除連線，請使用 AcceptTcpClient 方法或 AcceptSocket 方法。 方法 AcceptTcpClient 會從佇列中移除連線，並傳回 TcpClient 可用來傳送和接收資料的 。 方法 AcceptSocket 會傳回 Socket 可用來執行相同動作的 。 如果您的應用程式只需要同步 I/O，請使用 AcceptTcpClient。 如需更詳細的行為控制，請使用 AcceptSocket 方法。 這兩種方法都會封鎖，直到佇列中有連線要求為止。

Stop使用方法來關閉 TcpListener 並停止接聽。 您必須負責個別關閉已接受的連線。

注意

您可以使用 SocketException.ErrorCode 屬性取得特定的錯誤碼，並參閱 Windows Sockets 第 2 版 API 錯誤碼文件，以取得錯誤的詳細描述。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

另請參閱

• Listen(Int32)
• Bind(EndPoint)
• AcceptTcpClient()
• AcceptSocket()
• Stop()