TcpListener Конструкторы

Определение

Пространство имен:

System.Net.Sockets

Сборка:

System.Net.Sockets.dll

Инициализирует новый экземпляр класса TcpListener.

Перегрузки

TcpListener(Int32)	Устаревшие.. Инициализирует новый экземпляр класса TcpListener, который ожидает передачу данных для указанного порта.
TcpListener(IPEndPoint)	Инициализирует новый экземпляр класса TcpListener с заданной локальной конечной точкой.
TcpListener(IPAddress, Int32)	Инициализирует новый экземпляр класса TcpListener, который выполняет ожидание входящих попыток подключения для заданных локального IP-адреса и номера локального порта.

TcpListener(Int32)

Исходный код:

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)

Исходный код:

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-адрес и номер порта для прослушивания входящих попыток подключения. Перед использованием этого конструктора необходимо создать , используя требуемый локальный IPEndPoint IP-адрес и номер порта. Передайте его IPEndPoint конструктору в localEP качестве параметра .

Если вам не важно, какой локальный IPEndPoint адрес назначен, можно создать с помощью IPAddress.Any в качестве параметра address, а базовый поставщик услуг назначит наиболее подходящий сетевой адрес. Это может упростить работу приложения при наличии нескольких сетевых интерфейсов. Если вам не важно, какой локальный порт используется, можно создать IPEndPoint с помощью 0 для номера порта. В этом случае поставщик услуг назначит доступный временный номер порта. Если вы используете этот подход, вы можете узнать, какой адрес локальной сети и номер порта был назначен с помощью LocalEndpoint свойства .

Вызовите метод , Start чтобы начать прослушивание входящих попыток подключения.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в разделе Трассировка сети в платформа .NET Framework.

См. также раздел

• IPEndPoint
• Start()

TcpListener(IPAddress, Int32)

Исходный код:

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.

Примеры

В следующем примере кода создается экземпляр класса , TcpListener используя локальный IP-адрес и номер порта.

//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 качестве параметра . Если вам не важно, какой локальный адрес назначен, укажите IPAddress.Any для localaddr параметра , и базовый поставщик услуг назначит наиболее подходящий сетевой адрес. Это может упростить работу приложения при наличии нескольких сетевых интерфейсов. Если вам не важно, какой локальный порт используется, можно указать 0 для номера порта. В этом случае поставщик услуг назначит доступный номер порта в диапазоне от 1024 до 65535. Если вы используете этот подход, вы можете узнать, какой адрес локальной сети и номер порта был назначен с помощью LocalEndpoint свойства .

Вызовите метод , Start чтобы начать прослушивание входящих попыток подключения.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в разделе Трассировка сети в платформа .NET Framework.

См. также раздел

• IPAddress
• Start()