TcpListener.Start 方法

定义

命名空间:

System.Net.Sockets

程序集:

System.Net.Sockets.dll

开始侦听传入的连接请求。

重载

Start()	开始侦听传入的连接请求。
Start(Int32)	启动对具有最大挂起连接数的传入连接请求的侦听。

Start()

Source:

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)

Source:

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 为空。

示例

下面的代码示例演示如何 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()