Freigeben über

Socket.Listen Methode

Definition

Namespace:
System.Net.Sockets
Assemblys:
netstandard.dll, System.Net.Sockets.dll
Assemblys:
System.dll, System.Net.Sockets.dll
Assembly:
System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Überlädt

Name Beschreibung
Listen()

Platziert einen Socket Hörzustand.
Listen(Int32)

Platziert einen Socket Hörzustand.

Listen()

Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs

Platziert einen Socket Hörzustand.

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.

Gilt für:

Listen(Int32)

Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs
Quelle:
Socket.cs

Platziert einen Socket Hörzustand.

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 ausstehenden Verbindungswarteschlange.

Ausnahmen

SocketException

Beim Versuch, auf den Socket zuzugreifen, ist ein Fehler aufgetreten.

ObjectDisposedException

Das Socket wurde geschlossen.

Beispiele

Im folgenden Codebeispiel wird Socket verwendet, um eingehende Verbindungen zu überwachen.

    // 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 Überwachung auf eingehende Verbindungsversuche erfolgt. Der backlog Parameter gibt die Anzahl der eingehenden Verbindungen an, die zur Annahme in die Warteschlange gestellt werden können. Rufen Sie den Wert ab, um die maximale Anzahl von Verbindungen zu ermitteln, die MaxConnections Sie angeben können. Listen blockiert nicht.

Wenn Sie ein SocketExceptionObjekt erhalten, verwenden Sie die ErrorCode Eigenschaft, um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers. Verwenden oder BeginAccept akzeptieren Sie Accept eine Verbindung aus der Warteschlange.

Hinweis

Sie müssen die Bind Methode vor dem Aufrufen Listenaufrufen oder Listen eine .SocketException

Hinweis

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.

Hinweis

Der Backlog-Parameter 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 eingeschränkt.

Weitere Informationen

Gilt für: