TcpListener.Start 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
开始侦听传入的连接请求。
重载
| 名称 | 说明 |
|---|---|
| Start() |
开始侦听传入的连接请求。 |
| Start(Int32) |
开始侦听具有最大挂起连接数的传入连接请求。 |
Start()
- Source:
- TCPListener.cs
- Source:
- TCPListener.cs
- Source:
- TCPListener.cs
- Source:
- TCPListener.cs
- Source:
- TCPListener.cs
开始侦听传入的连接请求。
public:
void Start();
public void Start();
member this.Start : unit -> unit
Public Sub Start ()
例外
使用 ErrorCode 属性获取特定的错误代码。 获取此代码后,可以参阅 Windows 套接字版本 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 连接请求已排队后收到连接请求的最大连接数,则会在客户端上引发连接 SocketException 请求。
若要从传入的连接队列中删除连接,请使用 AcceptTcpClient 该方法或 AcceptSocket 方法。 该方法 AcceptTcpClient 将从队列中删除连接,并返回 TcpClient 可用于发送和接收数据的连接。 该方法 AcceptSocket 将返回一个 Socket 可用于执行相同操作的方法。 如果应用程序只需要同步 I/O,请使用 AcceptTcpClient。 有关更详细的行为控制,请使用 AcceptSocket。 这两种方法都阻止,直到连接请求在队列中可用。
Stop使用该方法关闭TcpListener和停止侦听。 你负责单独关闭接受的连接。
注释
在应用程序中启用网络跟踪时,此成员将输出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪。
另请参阅
适用于
Start(Int32)
- Source:
- TCPListener.cs
- Source:
- TCPListener.cs
- Source:
- TCPListener.cs
- Source:
- TCPListener.cs
- 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
挂起的连接队列的最大长度。
例外
访问套接字时出错。
该 backlog 参数小于零或超过允许的最大连接数。
基础 Socket 为 null。
示例
下面的代码示例演示如何 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 连接请求已排队后收到连接请求,它将在客户端上引发 SocketException 的最大连接数。
若要从传入的连接队列中删除连接,请使用 AcceptTcpClient 该方法或 AcceptSocket 方法。 该方法 AcceptTcpClient 将从队列中删除连接,并返回 TcpClient 可用于发送和接收数据的连接。 该方法 AcceptSocket 将返回一个 Socket 可用于执行相同操作的方法。 如果应用程序只需要同步 I/O,请使用 AcceptTcpClient. 有关更详细的行为控制,请使用 AcceptSocket 方法。 这两种方法都阻止,直到连接请求在队列中可用。
Stop使用该方法关闭TcpListener和停止侦听。 你负责单独关闭接受的连接。
注释
使用该 SocketException.ErrorCode 属性获取特定的错误代码,并参阅 Windows 套接字版本 2 API 错误代码 文档,获取错误的详细说明。
注释
在应用程序中启用网络跟踪时,此成员将输出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪。