Socket.Listen Methode

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Überlädt

Listen()	Versetzt einen Socket in den Überwachungszustand.
Listen(Int32)	Versetzt einen Socket in den Überwachungszustand.

Listen()

Quelle:

Socket.cs

Versetzt einen Socket in den Überwachungszustand.

public:
 void Listen();

public void Listen ();

member this.Listen : unit -> unit

Public Sub Listen ()

Hinweise

Die maximale Länge der ausstehenden Verbindungswarteschlange wird automatisch bestimmt.

Listen(Int32)

Quelle:

Socket.cs

Versetzt einen Socket in den Überwachungszustand.

public:
 void Listen(int backlog);

public void Listen (int backlog);

member this.Listen : int -> unit

Public Sub Listen (backlog As Integer)

Parameter

backlog

Int32

Die maximale Länge der Warteschlange für ausstehende Verbindungen.

Ausnahmen

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

ObjectDisposedException

Der Socket wurde geschlossen.

Beispiele

Im folgenden Codebeispiel wird verwendet Socket , um auf eingehende Verbindungen zu lauschen.

// create the socket
Socket^ listenSocket = gcnew 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 = gcnew IPEndPoint( hostIP,port );
listenSocket->Bind( ep );

// start listening
listenSocket->Listen( backlog );

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

Hinweise

Listen bewirkt, dass eine verbindungsorientierte Socket Verbindung auf eingehende Verbindungsversuche lauscht. Der backlog Parameter gibt die Anzahl der eingehenden Verbindungen an, die für die Akzeptanz in die Warteschlange gestellt werden können. Um die maximale Anzahl von Verbindungen zu bestimmen, die Sie angeben können, rufen Sie den Wert ab MaxConnections . Listen blockiert nicht.

Wenn Sie erhalten eine SocketException, verwenden die ErrorCode Eigenschaft, um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zur Windows Sockets-API, Version 2 . Verwenden Oder AcceptBeginAccept , um eine Verbindung aus der Warteschlange zu akzeptieren.

Hinweis

Sie müssen die Bind -Methode aufrufen, bevor Sie aufrufen Listen, oder Listen löst einen aus SocketException.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Hinweis

Der Backlogparameter ist abhängig vom Betriebssystem auf unterschiedliche Werte beschränkt. Sie können einen höheren Wert angeben, aber der Backlog wird basierend auf dem Betriebssystem begrenzt.

Weitere Informationen

• MaxConnections
• Accept()
• Bind(EndPoint)