TcpListener 构造函数

定义

命名空间:

System.Net.Sockets

程序集:

System.Net.Sockets.dll

初始化 TcpListener 类的新实例。

重载

TcpListener(Int32)	已过时. 初始化在指定端口上侦听的 TcpListener 类的新实例。
TcpListener(IPEndPoint)	使用指定的本地终结点初始化 TcpListener 类的新实例。
TcpListener(IPAddress, Int32)	初始化 TcpListener 类的新实例，该类在指定的本地 IP 地址和端口号上侦听是否有传入的连接尝试。

TcpListener(Int32)

Source:

TCPListener.cs

注意

This constructor has been deprecated. Use TcpListener(IPAddress localaddr, int port) instead.

初始化在指定端口上侦听的 TcpListener 类的新实例。

public:
 TcpListener(int port);

[System.Obsolete("This constructor has been deprecated. Use TcpListener(IPAddress localaddr, int port) instead.")]
public TcpListener (int port);

[<System.Obsolete("This constructor has been deprecated. Use TcpListener(IPAddress localaddr, int port) instead.")>]
new System.Net.Sockets.TcpListener : int -> System.Net.Sockets.TcpListener

Public Sub New (port As Integer)

参数

port

Int32

用来侦听传入的连接尝试的端口。

属性

ObsoleteAttribute

例外

ArgumentOutOfRangeException

port 不在 MinPort 和 MaxPort 之间。

示例

下面的代码示例使用本地端口号创建 TcpListener 。

//Creates an instance of the TcpListener class by providing a local port number.  

IPAddress^ ipAddress = Dns::Resolve( "localhost" )->AddressList[ 0 ];

try
{
   TcpListener^ tcpListener = gcnew TcpListener( ipAddress,13 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the TcpListener class by providing a local port number.
IPAddress ipAddress = Dns.Resolve("localhost").AddressList[0];
try{
    TcpListener tcpListener =  new TcpListener(ipAddress, 13);
}
catch ( Exception e ){
    Console.WriteLine( e.ToString());
}

   'Creates an instance of the TcpListener class by providing a local port number.  
   Dim ipAddress As IPAddress = Dns.Resolve("localhost").AddressList(0)
   Try
    Dim tcpListener As New TcpListener(ipAddress, 13)
   Catch e As Exception
      Console.WriteLine(e.ToString())
   End Try

注解

此构造函数已过时。 TcpListener.TcpListener(IPAddress, Int32)使用 或 TcpListener.TcpListener(IPEndPoint) 构造函数。

此构造函数允许指定侦听传入连接尝试的端口号。 使用此构造函数，基础服务提供程序分配最合适的网络地址。 如果不关心使用哪个本地端口，可以为端口号指定 0。 在这种情况下，服务提供商将分配可用的临时端口号。 如果使用此方法，则可以使用 LocalEndpoint 属性发现已分配的本地网络地址和端口号。

Start调用 方法以开始侦听传入的连接尝试。

另请参阅

• Start()

TcpListener(IPEndPoint)

Source:

TCPListener.cs

使用指定的本地终结点初始化 TcpListener 类的新实例。

public:
 TcpListener(System::Net::IPEndPoint ^ localEP);

public TcpListener (System.Net.IPEndPoint localEP);

new System.Net.Sockets.TcpListener : System.Net.IPEndPoint -> System.Net.Sockets.TcpListener

Public Sub New (localEP As IPEndPoint)

参数

localEP

IPEndPoint

一个 IPEndPoint，它表示将侦听器 Socket 绑定到的本地终结点。

例外

ArgumentNullException

localEP 为 null。

示例

下面的代码示例使用本地终结点创建 类的 TcpListener 实例。

//Creates an instance of the TcpListener class by providing a local endpoint.

IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );

try
{
   TcpListener^ tcpListener = gcnew TcpListener( ipLocalEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the TcpListener class by providing a local endpoint.

IPAddress ipAddress = Dns.Resolve(Dns.GetHostName()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);

try{
    TcpListener tcpListener = new TcpListener(ipLocalEndPoint);
}
catch ( Exception e ){
    Console.WriteLine( e.ToString());
}

'Creates an instance of the TcpListener class by providing a local endpoint.
Dim ipAddress As IPAddress = Dns.Resolve(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 11000)

Try
   Dim tcpListener As New TcpListener(ipLocalEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注解

此构造函数允许指定要侦听传入连接尝试的本地 IP 地址和端口号。 使用此构造函数之前，必须使用所需的本地 IP 地址和端口号创建 IPEndPoint 。 将此 IPEndPoint 作为 参数传递给构造函数 localEP 。

如果不关心分配哪个本地地址，可以使用 作为地址参数创建 IPEndPointIPAddress.Any ，基础服务提供商将分配最合适的网络地址。 如果有多个网络接口，这可能有助于简化应用程序。 如果不关心使用哪个本地端口，可以使用 0 为端口号创建 IPEndPoint 。 在这种情况下，服务提供商将分配可用的临时端口号。 如果使用此方法，则可以使用 LocalEndpoint 属性发现已分配的本地网络地址和端口号。

Start调用 方法以开始侦听传入的连接尝试。

备注

当你在应用程序中启用网络跟踪后，此成员将输出跟踪信息。 有关详细信息，请参阅.NET Framework中的网络跟踪。

另请参阅

• IPEndPoint
• Start()

TcpListener(IPAddress, Int32)

Source:

TCPListener.cs

初始化 TcpListener 类的新实例，该类在指定的本地 IP 地址和端口号上侦听是否有传入的连接尝试。

public:
 TcpListener(System::Net::IPAddress ^ localaddr, int port);

public TcpListener (System.Net.IPAddress localaddr, int port);

new System.Net.Sockets.TcpListener : System.Net.IPAddress * int -> System.Net.Sockets.TcpListener

Public Sub New (localaddr As IPAddress, port As Integer)

参数

localaddr

IPAddress

一个 IPAddress，它表示本地 IP 地址。

port

Int32

用来侦听传入的连接尝试的端口。

例外

ArgumentNullException

localaddr 为 null。

ArgumentOutOfRangeException

port 不在 MinPort 和 MaxPort 之间。

示例

下面的代码示例使用本地 IP 地址和端口号创建 类的 TcpListener 实例。

//Creates an instance of the TcpListener class by providing a local IP address and port number.

IPAddress^ ipAddress = Dns::Resolve( "localhost" )->AddressList[ 0 ];

try
{
   TcpListener^ tcpListener = gcnew TcpListener( ipAddress,13 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the TcpListener class by providing a local IP address and port number.

IPAddress ipAddress = Dns.Resolve("localhost").AddressList[0];

try{
    TcpListener tcpListener =  new TcpListener(ipAddress, 13);
}
catch ( Exception e){
    Console.WriteLine( e.ToString());
}

   'Creates an instance of the TcpListener class by providing a local IP address and port number.
   Dim ipAddress As IPAddress = Dns.Resolve("localhost").AddressList(0)
   
   Try
      Dim tcpListener As New TcpListener(ipAddress, 13)
   Catch e As Exception
      Console.WriteLine(e.ToString())
   End Try

注解

此构造函数允许指定要侦听传入连接尝试的本地 IP 地址和端口号。 在调用此构造函数之前， IPAddress 必须先使用所需的本地地址创建 。 将此 IPAddress 作为 参数传递给构造函数 localaddr 。 如果不关心分配哪个本地地址，请为 localaddr 参数指定 IPAddress.Any ，基础服务提供商将分配最合适的网络地址。 如果有多个网络接口，这可能有助于简化应用程序。 如果不关心使用哪个本地端口，可以为端口号指定 0。 在这种情况下，服务提供商将分配介于 1024 和 65535 之间的可用端口号。 如果使用此方法，则可以使用 LocalEndpoint 属性发现已分配的本地网络地址和端口号。

Start调用 方法以开始侦听传入的连接尝试。

备注

当你在应用程序中启用网络跟踪后，此成员将输出跟踪信息。 有关详细信息，请参阅.NET Framework中的网络跟踪。

另请参阅

• IPAddress
• Start()