TcpListener TcpListener TcpListener TcpListener Class

Определение

Прослушивает подключения от TCP-клиентов сети.Listens for connections from TCP network clients.

public ref class TcpListener
public class TcpListener
type TcpListener = class
Public Class TcpListener
Наследование
TcpListenerTcpListenerTcpListenerTcpListener

Примеры

В следующем примере кода создается TcpListener.The following code example creates a TcpListener.

#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Net;
using namespace System::Net::Sockets;
using namespace System::Text;
using namespace System::Threading;
void main()
{
   try
   {
      
      // Set the TcpListener on port 13000.
      Int32 port = 13000;
      IPAddress^ localAddr = IPAddress::Parse( "127.0.0.1" );
      
      // TcpListener* server = new TcpListener(port);
      TcpListener^ server = gcnew TcpListener( localAddr,port );
      
      // Start listening for client requests.
      server->Start();
      
      // Buffer for reading data
      array<Byte>^bytes = gcnew array<Byte>(256);
      String^ data = nullptr;
      
      // Enter the listening loop.
      while ( true )
      {
         Console::Write( "Waiting for a connection... " );
         
         // Perform a blocking call to accept requests.
         // You could also user server.AcceptSocket() here.
         TcpClient^ client = server->AcceptTcpClient();
         Console::WriteLine( "Connected!" );
         data = nullptr;
         
         // Get a stream Object* for reading and writing
         NetworkStream^ stream = client->GetStream();
         Int32 i;
         
         // Loop to receive all the data sent by the client.
         while ( i = stream->Read( bytes, 0, bytes->Length ) )
         {
            
            // Translate data bytes to a ASCII String*.
            data = Text::Encoding::ASCII->GetString( bytes, 0, i );
            Console::WriteLine( "Received: {0}", data );
            
            // Process the data sent by the client.
            data = data->ToUpper();
            array<Byte>^msg = Text::Encoding::ASCII->GetBytes( data );
            
            // Send back a response.
            stream->Write( msg, 0, msg->Length );
            Console::WriteLine( "Sent: {0}", data );
         }
         
         // Shutdown and end connection
         client->Close();
      }
   }
   catch ( SocketException^ e ) 
   {
      Console::WriteLine( "SocketException: {0}", e );
   }

   Console::WriteLine( "\nHit enter to continue..." );
   Console::Read();
}


using System;
using System.IO;
using System.Net;
using System.Net.Sockets;
using System.Text;

class MyTcpListener
{
  public static void Main()
  { 
    TcpListener server=null;   
    try
    {
      // Set the TcpListener on port 13000.
      Int32 port = 13000;
      IPAddress localAddr = IPAddress.Parse("127.0.0.1");
      
      // TcpListener server = new TcpListener(port);
      server = new TcpListener(localAddr, port);

      // Start listening for client requests.
      server.Start();
         
      // Buffer for reading data
      Byte[] bytes = new Byte[256];
      String data = null;

      // Enter the listening loop.
      while(true) 
      {
        Console.Write("Waiting for a connection... ");
        
        // Perform a blocking call to accept requests.
        // You could also user server.AcceptSocket() here.
        TcpClient client = server.AcceptTcpClient();            
        Console.WriteLine("Connected!");

        data = null;

        // Get a stream object for reading and writing
        NetworkStream stream = client.GetStream();

        int i;

        // Loop to receive all the data sent by the client.
        while((i = stream.Read(bytes, 0, bytes.Length))!=0) 
        {   
          // Translate data bytes to a ASCII string.
          data = System.Text.Encoding.ASCII.GetString(bytes, 0, i);
          Console.WriteLine("Received: {0}", data);
       
          // Process the data sent by the client.
          data = data.ToUpper();

          byte[] msg = System.Text.Encoding.ASCII.GetBytes(data);

          // Send back a response.
          stream.Write(msg, 0, msg.Length);
          Console.WriteLine("Sent: {0}", data);            
        }
         
        // Shutdown and end connection
        client.Close();
      }
    }
    catch(SocketException e)
    {
      Console.WriteLine("SocketException: {0}", e);
    }
    finally
    {
       // Stop listening for new clients.
       server.Stop();
    }

      
    Console.WriteLine("\nHit enter to continue...");
    Console.Read();
  }   
}
Imports System
Imports System.IO
Imports System.Net
Imports System.Net.Sockets
Imports System.Text
Imports Microsoft.VisualBasic


Class MyTcpListener

    Public Shared Sub Main()

	Dim server As TcpListener
	server=nothing
        Try
            ' Set the TcpListener on port 13000.
         Dim port As Int32 = 13000
         Dim localAddr As IPAddress = IPAddress.Parse("127.0.0.1")

         server = New TcpListener(localAddr, port)
         
         ' Start listening for client requests.
         server.Start()
         
         ' Buffer for reading data
            Dim bytes(1024) As Byte
            Dim data As String = Nothing
         
         ' Enter the listening loop.
         While True
            Console.Write("Waiting for a connection... ")
            
            ' Perform a blocking call to accept requests.
            ' You could also user server.AcceptSocket() here.
            Dim client As TcpClient = server.AcceptTcpClient()
            Console.WriteLine("Connected!")
            
            data = Nothing
            
            ' Get a stream object for reading and writing
            Dim stream As NetworkStream = client.GetStream()
            
            Dim i As Int32
            
            ' Loop to receive all the data sent by the client.
            i = stream.Read(bytes, 0, bytes.Length)
            While (i <> 0) 
               ' Translate data bytes to a ASCII string.
               data = System.Text.Encoding.ASCII.GetString(bytes, 0, i)
                    Console.WriteLine("Received: {0}", data)
               
               ' Process the data sent by the client.
               data = data.ToUpper()
                    Dim msg As Byte() = System.Text.Encoding.ASCII.GetBytes(data)
               
               ' Send back a response.
               stream.Write(msg, 0, msg.Length)
                    Console.WriteLine("Sent: {0}", data)
              
               i = stream.Read(bytes, 0, bytes.Length)

            End While
            
            ' Shutdown and end connection
            client.Close()
         End While
      Catch e As SocketException
         Console.WriteLine("SocketException: {0}", e)
      Finally
         server.Stop()
      End Try
      
      Console.WriteLine(ControlChars.Cr + "Hit enter to continue....")
      Console.Read()
   End Sub 'Main

End Class 'MyTcpListener 

См. в разделе TcpClient пример для клиента.See TcpClient for a client example.

Комментарии

TcpListener Класс предоставляет простые методы, предназначенные для ожидания и приема входящих запросов на подключение в синхронном режиме блокировки.The TcpListener class provides simple methods that listen for and accept incoming connection requests in blocking synchronous mode. Можно использовать либо TcpClient или Socket к сообществу TcpListener.You can use either a TcpClient or a Socket to connect with a TcpListener. Создание TcpListener с помощью IPEndPoint, локальный IP-адрес и номер порта или номер порта.Create a TcpListener using an IPEndPoint, a Local IP address and port number, or just a port number. Укажите Any для локального IP-адреса и 0 номер локального порта, если требуется, чтобы у основного поставщика услуг, чтобы назначить эти значения автоматически.Specify Any for the local IP address and 0 for the local port number if you want the underlying service provider to assign those values for you. Если вы решили сделать это, можно использовать LocalEndpoint свойство для идентификации связанных сведений, после подключения сокета.If you choose to do this, you can use the LocalEndpoint property to identify the assigned information, after the socket has connected.

Используйте Start метод, чтобы начать прослушивание входящих запросов на подключение.Use the Start method to begin listening for incoming connection requests. Start очередь входящих подключений до вызова Stop метода или он поставил в очередь MaxConnections.Start will queue incoming connections until you either call the Stop method or it has queued MaxConnections. Использовать AcceptSocket или AcceptTcpClient для приема подключения из входной очереди запросов.Use either AcceptSocket or AcceptTcpClient to pull a connection from the incoming connection request queue. Эти два метода будет блокировать.These two methods will block. Если вы хотите избежать блокирования, можно использовать Pending метод, чтобы определить, если запросы на подключение в очереди.If you want to avoid blocking, you can use the Pending method first to determine if connection requests are available in the queue.

Вызовите Stop метод для закрытия TcpListener.Call the Stop method to close the TcpListener.

Примечание

Stop Метод не закрывает все допустимые подключения.The Stop method does not close any accepted connections. Вы отвечаете за закрытие их отдельно.You are responsible for closing these separately.

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

TcpListener(Int32) TcpListener(Int32) TcpListener(Int32) TcpListener(Int32)

Инициализирует новый экземпляр класса TcpListener, который ожидает передачу данных для указанного порта.Initializes a new instance of the TcpListener class that listens on the specified port.

TcpListener(IPAddress, Int32) TcpListener(IPAddress, Int32) TcpListener(IPAddress, Int32) TcpListener(IPAddress, Int32)

Инициализирует новый экземпляр класса TcpListener, который выполняет ожидание входящих попыток подключения для заданных локального IP-адреса и номера локального порта.Initializes a new instance of the TcpListener class that listens for incoming connection attempts on the specified local IP address and port number.

TcpListener(IPEndPoint) TcpListener(IPEndPoint) TcpListener(IPEndPoint) TcpListener(IPEndPoint)

Инициализирует новый экземпляр класса TcpListener с заданной локальной конечной точкой.Initializes a new instance of the TcpListener class with the specified local endpoint.

Свойства

Active Active Active Active

Получает значение, указывающее, является ли активным объект TcpListener, выполняющий прослушивание клиентских подключений.Gets a value that indicates whether TcpListener is actively listening for client connections.

ExclusiveAddressUse ExclusiveAddressUse ExclusiveAddressUse ExclusiveAddressUse

Возвращает или задает значение Boolean, указывающее, позволяет ли объект TcpListener осуществлять ожидание передачи данных только на одном основном сокете на указанном порту.Gets or sets a Boolean value that specifies whether the TcpListener allows only one underlying socket to listen to a specific port.

LocalEndpoint LocalEndpoint LocalEndpoint LocalEndpoint

Получает основной объект EndPoint для текущего объекта TcpListener.Gets the underlying EndPoint of the current TcpListener.

Server Server Server Server

Получает основной сетевой объект Socket.Gets the underlying network Socket.

Методы

AcceptSocket() AcceptSocket() AcceptSocket() AcceptSocket()

Принимает ожидающий запрос на подключение.Accepts a pending connection request.

AcceptSocketAsync() AcceptSocketAsync() AcceptSocketAsync() AcceptSocketAsync()

Принимает запрос ожидающего подключения как асинхронную операцию.Accepts a pending connection request as an asynchronous operation.

AcceptTcpClient() AcceptTcpClient() AcceptTcpClient() AcceptTcpClient()

Принимает ожидающий запрос на подключение.Accepts a pending connection request.

AcceptTcpClientAsync() AcceptTcpClientAsync() AcceptTcpClientAsync() AcceptTcpClientAsync()

Принимает запрос ожидающего подключения как асинхронную операцию.Accepts a pending connection request as an asynchronous operation.

AllowNatTraversal(Boolean) AllowNatTraversal(Boolean) AllowNatTraversal(Boolean) AllowNatTraversal(Boolean)

Включает или отключает обход механизма преобразования сетевых адресов (NAT) для экземпляра TcpListener.Enables or disables Network Address Translation (NAT) traversal on a TcpListener instance.

BeginAcceptSocket(AsyncCallback, Object) BeginAcceptSocket(AsyncCallback, Object) BeginAcceptSocket(AsyncCallback, Object) BeginAcceptSocket(AsyncCallback, Object)

Начинает асинхронную операцию, чтобы принять попытку входящего подключения.Begins an asynchronous operation to accept an incoming connection attempt.

BeginAcceptTcpClient(AsyncCallback, Object) BeginAcceptTcpClient(AsyncCallback, Object) BeginAcceptTcpClient(AsyncCallback, Object) BeginAcceptTcpClient(AsyncCallback, Object)

Начинает асинхронную операцию, чтобы принять попытку входящего подключения.Begins an asynchronous operation to accept an incoming connection attempt.

Create(Int32) Create(Int32) Create(Int32) Create(Int32)

Создает Новый экземпляр TcpListener, который должен прослушивать на определенном порту.Creates a new TcpListener instance to listen on the specified port.

EndAcceptSocket(IAsyncResult) EndAcceptSocket(IAsyncResult) EndAcceptSocket(IAsyncResult) EndAcceptSocket(IAsyncResult)

Асинхронно принимает входящие попытки подключения и создает новый объект Socket для связи с удаленным узлом.Asynchronously accepts an incoming connection attempt and creates a new Socket to handle remote host communication.

EndAcceptTcpClient(IAsyncResult) EndAcceptTcpClient(IAsyncResult) EndAcceptTcpClient(IAsyncResult) EndAcceptTcpClient(IAsyncResult)

Асинхронно принимает входящие попытки подключения и создает новый объект TcpClient для связи с удаленным узлом.Asynchronously accepts an incoming connection attempt and creates a new TcpClient to handle remote host communication.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Освобождает ресурсы, используемые классом TcpListener.Frees resources used by the TcpListener class.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Pending() Pending() Pending() Pending()

Определяет, имеются ли ожидающие запросы на подключение.Determines if there are pending connection requests.

Start() Start() Start() Start()

Запускает ожидание входящих запросов на подключение.Starts listening for incoming connection requests.

Start(Int32) Start(Int32) Start(Int32) Start(Int32)

Запускает ожидание входящих запросов на подключение с максимальным числом ожидающих подключений.Starts listening for incoming connection requests with a maximum number of pending connection.

Stop() Stop() Stop() Stop()

Закрывает слушатель.Closes the listener.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Безопасность

SocketPermission
Чтобы установить исходящее подключение, или принять входящий запрос.to establish an outgoing connection or accept an incoming request.

Применяется к

Дополнительно