TcpListener Třída

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

netstandard.dll, System.Net.Sockets.dll

Zdroj:

TCPListener.cs

Naslouchá připojení ze síťových klientů TCP.

public ref class TcpListener : IDisposable

public class TcpListener : IDisposable

type TcpListener = class
    interface IDisposable

Public Class TcpListener
Implements IDisposable

Dědičnost

Object

TcpListener

Implementuje

IDisposable

Příklady

Následující příklad kódu vytvoří TcpListener.

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 use server.AcceptSocket() here.
        using 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);
        }
      }
    }
    catch(SocketException e)
    {
      Console.WriteLine("SocketException: {0}", e);
    }
    finally
    {
      server.Stop();
    }

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

Imports System.IO
Imports System.Net
Imports System.Net.Sockets
Imports System.Text

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 use 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

End Class

Podívejte se TcpClient na příklad klienta.

Poznámky

Třída TcpListener poskytuje jednoduché metody, které naslouchají příchozím požadavkům připojení a přijímají je v synchronním režimu blokování. Můžete použít buď a TcpClient , nebo a Socket připojit se s TcpListener. Vytvořte TcpListener pomocí IPEndPointadresy , místní IP adresy a čísla portu nebo jenom čísla portu. Zadejte Any pro místní IP adresu a 0 pro číslo místního portu, pokud chcete, aby podkladový poskytovatel služeb tyto hodnoty přiřadil za vás. Pokud se rozhodnete tuto akci provést, můžete pomocí LocalEndpoint vlastnosti identifikovat přiřazené informace po připojení soketu.

Start Pomocí metody začněte naslouchat příchozím požadavkům připojení. Start zařadí příchozí připojení do fronty, dokud metodu Stop nevoláte nebo se zařadí do fronty MaxConnections. Použijte buď AcceptSocket nebo AcceptTcpClient k vyžádání připojení z fronty příchozích žádostí o připojení. Tyto dvě metody se zablokují. Pokud se chcete vyhnout blokování, můžete nejprve použít metodu Pending k určení, jestli jsou žádosti o připojení k dispozici ve frontě.

Stop Voláním metody zavřete TcpListener.

Note

Metoda Stop nezavírá žádná přijatá připojení. Zodpovídáte za jejich uzavření samostatně.

Konstruktory

Name	Description
TcpListener(Int32)	Zastaralé. Inicializuje novou instanci TcpListener třídy, která naslouchá na zadaném portu.
TcpListener(IPAddress, Int32)	Inicializuje novou instanci TcpListener třídy, která naslouchá příchozím pokusům o připojení na zadané místní IP adrese a čísle portu.
TcpListener(IPEndPoint)	Inicializuje novou instanci TcpListener třídy se zadaným místním koncovým bodem.

Vlastnosti

Name	Description
Active	Získá hodnotu, která označuje, zda TcpListener aktivně naslouchá klientským připojením.
ExclusiveAddressUse	Získá nebo nastaví Boolean hodnotu, která určuje, zda TcpListener umožňuje pouze jeden základní soket naslouchat určitému portu.
LocalEndpoint	Získá podklad EndPoint aktuálního TcpListener.
Server	Získá základní síť Socket.

Metody

Name	Description
AcceptSocket()	Přijme nevyřízenou žádost o připojení.
AcceptSocketAsync()	Přijímá nevyřízenou žádost o připojení jako asynchronní operaci.
AcceptSocketAsync(CancellationToken)	Přijímá nevyřízenou žádost o připojení jako zrušenou asynchronní operaci.
AcceptTcpClient()	Přijme nevyřízenou žádost o připojení.
AcceptTcpClientAsync()	Přijímá nevyřízenou žádost o připojení jako asynchronní operaci.
AcceptTcpClientAsync(CancellationToken)	Přijímá nevyřízenou žádost o připojení jako zrušenou asynchronní operaci.
AllowNatTraversal(Boolean)	Povolí nebo zakáže procházení překladu adres (NAT) v TcpListener instanci.
BeginAcceptSocket(AsyncCallback, Object)	Zahájí asynchronní operaci, která přijme příchozí pokus o připojení.
BeginAcceptTcpClient(AsyncCallback, Object)	Zahájí asynchronní operaci, která přijme příchozí pokus o připojení.
Create(Int32)	Vytvoří novou TcpListener instanci pro naslouchání na zadaném portu.
Dispose()	Uvolní všechny prostředky používané aktuální TcpListener instancí.
EndAcceptSocket(IAsyncResult)	Asynchronně přijímá příchozí pokus o připojení a vytvoří nový Socket pro zpracování komunikace vzdáleného hostitele.
EndAcceptTcpClient(IAsyncResult)	Asynchronně přijímá příchozí pokus o připojení a vytvoří nový TcpClient pro zpracování komunikace vzdáleného hostitele.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Pending()	Určuje, jestli existují nevyřízené žádosti o připojení.
Start()	Začne naslouchat příchozím požadavkům na připojení.
Start(Int32)	Začne naslouchat příchozím požadavkům připojení s maximálním počtem čekajících připojení.
Stop()	Zavře naslouchací proces.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• TcpClient