Freigeben über


TcpListener.Start Methode

Definition

Startet die Überwachung eingehender Verbindungsanforderungen.

Überlädt

Name Beschreibung
Start()

Startet die Überwachung eingehender Verbindungsanforderungen.

Start(Int32)

Startet die Überwachung eingehender Verbindungsanforderungen mit einer maximalen Anzahl ausstehender Verbindung.

Start()

Quelle:
TCPListener.cs
Quelle:
TCPListener.cs
Quelle:
TCPListener.cs
Quelle:
TCPListener.cs
Quelle:
TCPListener.cs

Startet die Überwachung eingehender Verbindungsanforderungen.

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

Ausnahmen

Verwenden Sie die ErrorCode Eigenschaft, um den spezifischen Fehlercode abzurufen. Wenn Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Start auf eingehende Clientverbindungsversuche überwacht wird.

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

Hinweise

Die Start Methode initialisiert die zugrunde liegende SocketMethode, bindet sie an einen lokalen Endpunkt und überwacht eingehende Verbindungsversuche. Wenn eine Verbindungsanforderung empfangen wird, wird die Start Anforderung in die Warteschlange eingereiht und die Überwachung weiterer Anforderungen fortgesetzt, bis Sie die Stop Methode aufrufen. Wenn TcpListener eine Verbindungsanforderung empfangen wird, nachdem sie bereits die maximale Anzahl von Verbindungen in die Warteschlange gestellt hat, löst sie einen SocketException auf dem Client aus.

Um eine Verbindung aus der eingehenden Verbindungswarteschlange zu entfernen, verwenden Sie entweder die AcceptTcpClient Methode oder die AcceptSocket Methode. Die AcceptTcpClient Methode entfernt eine Verbindung aus der Warteschlange und gibt einen TcpClient Wert zurück, den Sie zum Senden und Empfangen von Daten verwenden können. Die AcceptSocket Methode gibt eine Socket Methode zurück, die Sie verwenden können, um dasselbe zu tun. Wenn Ihre Anwendung nur synchrone E/A erfordert, verwenden Sie AcceptTcpClient. Verwenden Sie AcceptSocketfür eine detailliertere Verhaltenssteuerung . Beide Methoden blockieren, bis eine Verbindungsanforderung in der Warteschlange verfügbar ist.

Verwenden Sie die Stop Methode, um die TcpListener Überwachung zu schließen und zu beenden. Sie sind dafür verantwortlich, Ihre akzeptierten Verbindungen separat zu schließen.

Hinweis

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

Weitere Informationen

Gilt für:

Start(Int32)

Quelle:
TCPListener.cs
Quelle:
TCPListener.cs
Quelle:
TCPListener.cs
Quelle:
TCPListener.cs
Quelle:
TCPListener.cs

Startet die Überwachung eingehender Verbindungsanforderungen mit einer maximalen Anzahl ausstehender Verbindung.

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

Parameter

backlog
Int32

Die maximale Länge der ausstehenden Verbindungswarteschlange.

Ausnahmen

Fehler beim Zugriff auf den Socket.

Der backlog Parameter ist kleiner als Null oder überschreitet die maximale Anzahl zulässiger Verbindungen.

Der zugrunde liegende Socket Wert ist NULL.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Start auf eingehende Clientverbindungsversuche überwacht wird.

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

Hinweise

Die Start Methode initialisiert die zugrunde liegende SocketMethode, bindet sie an einen lokalen Endpunkt und überwacht eingehende Verbindungsversuche. Wenn eine Verbindungsanforderung empfangen wird, wird die Anforderung in die Warteschlange gestellt und die Überwachung zusätzlicher Anforderungen fortgesetzt, Start bis Sie die Stop Methode aufrufen. Wenn TcpListener eine Verbindungsanforderung empfangen wird, nachdem sie bereits die maximale Anzahl von Verbindungen in die Warteschlange gestellt hat, löst sie einen SocketException auf dem Client aus.

Um eine Verbindung aus der eingehenden Verbindungswarteschlange zu entfernen, verwenden Sie entweder die AcceptTcpClient Methode oder die AcceptSocket Methode. Die AcceptTcpClient Methode entfernt eine Verbindung aus der Warteschlange und gibt einen TcpClient Wert zurück, den Sie zum Senden und Empfangen von Daten verwenden können. Die AcceptSocket Methode gibt eine Socket Methode zurück, die Sie verwenden können, um dasselbe zu tun. Wenn Ihre Anwendung nur synchrone E/A erfordert, verwenden Sie die AcceptTcpClient. Verwenden Sie eine Methode, um eine detailliertere Verhaltenssteuerung zu finden AcceptSocket . Beide Methoden blockieren, bis eine Verbindungsanforderung in der Warteschlange verfügbar ist.

Verwenden Sie die Stop Methode, um die TcpListener Überwachung zu schließen und zu beenden. Sie sind dafür verantwortlich, Ihre akzeptierten Verbindungen separat zu schließen.

Hinweis

Verwenden Sie die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode abzurufen, und verweisen Sie auf die Fehlercodedokumentation der Windows Sockets Version 2 , um eine detaillierte Beschreibung des Fehlers zu erhalten.

Hinweis

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

Weitere Informationen

Gilt für: