Socket.Listen(Int32) Methode

Definitie

Naamruimte:
System.Net.Sockets
Assembly's:
System.dll, System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
System.Net.Sockets.dll
Assembly:
netstandard.dll

Plaatst een Socket in een luistertoestand.

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

Parameters

backlog
Int32

De maximale lengte van de wachtrij voor in behandeling zijnde verbindingen.

Uitzonderingen

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

Voorbeelden

In het volgende codevoorbeeld wordt gebruikgemaakt Socket van het luisteren naar binnenkomende verbindingen.

    // create the socket
    Socket listenSocket = new Socket(AddressFamily.InterNetwork,
                                     SocketType.Stream,
                                     ProtocolType.Tcp);

    // bind the listening socket to the port
IPAddress hostIP = (Dns.Resolve(IPAddress.Any.ToString())).AddressList[0];
    IPEndPoint ep = new IPEndPoint(hostIP, port);
    listenSocket.Bind(ep);

    // start listening
    listenSocket.Listen(backlog);

   ' create the socket
   Dim listenSocket As New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)
   
   ' bind the listening socket to the port
   Dim hostIP As IPAddress = Dns.Resolve(IPAddress.Any.ToString()).AddressList(0)
   Dim ep As New IPEndPoint(hostIP, port)
   listenSocket.Bind(ep)
   
   ' start listening
   listenSocket.Listen(backlog)
End Sub

Opmerkingen

Listen zorgt ervoor dat een verbinding gericht Socket is op het luisteren naar binnenkomende verbindingspogingen. De backlog parameter geeft het aantal binnenkomende verbindingen op dat in de wachtrij kan worden geplaatst voor acceptatie. Als u het maximum aantal verbindingen wilt bepalen dat u kunt opgeven, haalt u de MaxConnections waarde op. Listen blokkeert niet.

Als u een SocketExceptionontvangt, gebruikt u de ErrorCode eigenschap om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, raadpleegt u de Windows Sockets versie 2 API-foutcode documentatie voor een gedetailleerde beschrijving van de fout. Gebruik Accept of BeginAccept accepteer een verbinding vanuit de wachtrij.

Note

U moet de Bind methode aanroepen voordat u aanroept Listenof Listen een SocketException.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Note

De backlogparameter is beperkt tot verschillende waarden, afhankelijk van het besturingssysteem. U kunt een hogere waarde opgeven, maar de achterstand wordt beperkt op basis van het besturingssysteem.

Van toepassing op

Zie ook