TcpListener.Start Metod

Definition

Namnområde:
System.Net.Sockets
Sammansättningar:
netstandard.dll, System.Net.Sockets.dll
Sammansättning:
System.Net.Sockets.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Börjar lyssna efter inkommande anslutningsbegäranden.

Överlagringar

Name Description
Start()

Börjar lyssna efter inkommande anslutningsbegäranden.
Start(Int32)

Börjar lyssna efter inkommande anslutningsbegäranden med ett maximalt antal väntande anslutningar.

Start()

Källa:
TCPListener.cs
Källa:
TCPListener.cs
Källa:
TCPListener.cs
Källa:
TCPListener.cs
Källa:
TCPListener.cs

Börjar lyssna efter inkommande anslutningsbegäranden.

public:
 void Start();
public void Start();
member this.Start : unit -> unit
Public Sub Start ()

Undantag

SocketException

Använd egenskapen ErrorCode för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 API för en detaljerad beskrivning av felet.

Exempel

Följande kodexempel visar hur Start används för att lyssna efter inkommande klientanslutningsförsök.

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

Kommentarer

Metoden Start initierar den underliggande Socket, binder den till en lokal slutpunkt och lyssnar efter inkommande anslutningsförsök. Om en anslutningsbegäran tas emot Start köar metoden begäran och fortsätter att lyssna efter ytterligare begäranden tills du anropar Stop metoden. Om TcpListener du får en anslutningsbegäran när den redan har placerat det maximala antalet anslutningar i kö, utlöser den en SocketException på klienten.

Om du vill ta bort en anslutning från den inkommande anslutningskön använder du antingen AcceptTcpClient metoden eller AcceptSocket metoden. Metoden AcceptTcpClient tar bort en anslutning från kön och returnerar en TcpClient som du kan använda för att skicka och ta emot data. Metoden AcceptSocket returnerar en Socket som du kan använda för att göra samma sak. Om programmet bara kräver synkron I/O använder du AcceptTcpClient. Mer detaljerad beteendekontroll finns i AcceptSocket. Båda dessa metoder blockeras tills en anslutningsbegäran är tillgänglig i kön.

Stop Använd metoden för att stänga TcpListener och sluta lyssna. Du ansvarar för att stänga dina godkända anslutningar separat.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.

Se även

Gäller för

Start(Int32)

Källa:
TCPListener.cs
Källa:
TCPListener.cs
Källa:
TCPListener.cs
Källa:
TCPListener.cs
Källa:
TCPListener.cs

Börjar lyssna efter inkommande anslutningsbegäranden med ett maximalt antal väntande anslutningar.

public:
 void Start(int backlog);
public void Start(int backlog);
member this.Start : int -> unit
Public Sub Start (backlog As Integer)

Parametrar

backlog
Int32

Den maximala längden på kön för väntande anslutningar.

Undantag

SocketException

Ett fel uppstod vid åtkomst till socketen.

ArgumentOutOfRangeException

Parametern backlog är mindre än noll eller överskrider det maximala antalet tillåtna anslutningar.

InvalidOperationException

Den underliggande Socket är null.

Exempel

Följande kodexempel visar hur Start används för att lyssna efter inkommande klientanslutningsförsök.

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

Kommentarer

Metoden Start initierar den underliggande Socket, binder den till en lokal slutpunkt och lyssnar efter inkommande anslutningsförsök. Om en anslutningsbegäran tas emot Start köar du begäran och fortsätter att lyssna efter ytterligare begäranden tills du anropar Stop metoden. Om TcpListener du får en anslutningsbegäran när den redan har placerat det maximala antalet anslutningar i kö kommer den att generera en SocketException på klienten.

Om du vill ta bort en anslutning från den inkommande anslutningskön använder du antingen AcceptTcpClient metoden eller AcceptSocket metoden. Metoden AcceptTcpClient tar bort en anslutning från kön och returnerar en TcpClient som du kan använda för att skicka och ta emot data. Metoden AcceptSocket returnerar en Socket som du kan använda för att göra samma sak. Om programmet bara kräver synkron I/O använder du AcceptTcpClient. Använd metoden för mer detaljerad beteendekontroll AcceptSocket . Båda dessa metoder blockeras tills en anslutningsbegäran är tillgänglig i kön.

Stop Använd metoden för att stänga TcpListener och sluta lyssna. Du ansvarar för att stänga dina godkända anslutningar separat.

Note

Använd egenskapen SocketException.ErrorCode för att hämta den specifika felkoden och se Windows Sockets version 2 API-felkoden dokumentation för en detaljerad beskrivning av felet.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.

Se även

Gäller för