TcpListener.Start Methode

Definition

Beginnt die Überwachung von eingehenden Verbindungsanforderungen.

Überlädt

Start()

Beginnt die Überwachung von eingehenden Verbindungsanforderungen.

Start(Int32)

Beginnt die Überwachung eingehender Verbindungsanforderungen mit einer maximalen Anzahl ausstehender Verbindungen.

Start()

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

Beginnt die Überwachung von eingehenden Verbindungsanforderungen.

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

Ausnahmen

Mit der ErrorCode-Eigenschaft können Sie den spezifischen Fehlercode abrufen. Wenn Sie diesen Code abgerufen haben, finden Sie in der Dokumentation zu API-Fehlercodes unter Windows Sockets, Version 2, eine ausführliche Beschreibung des Fehlers.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Start zum Lauschen auf eingehende Clientverbindungsversuche verwendet wird.

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }
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 den zugrunde liegenden Socket, bindet ihn an einen lokalen Endpunkt und lauscht auf eingehende Verbindungsversuche. Wenn eine Verbindungsanforderung empfangen wird, wird die -Methode die Start Anforderung in die Warteschlange stellen und weiterhin auf zusätzliche Anforderungen lauschen, bis Sie die Stop -Methode aufrufen. Wenn TcpListener eine Verbindungsanforderung empfangen wird, nachdem die maximale Anzahl von Verbindungen bereits in die Warteschlange eingereiht wurde, wird auf dem Client eine SocketException ausgelöst.

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 eine zurück TcpClient , die Sie zum Senden und Empfangen von Daten verwenden können. Die AcceptSocket -Methode gibt eine Socket zurück, die Sie auch verwenden können. Wenn Ihre Anwendung nur synchrone E/A-Vorgänge 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 -Methode zu schließen und das TcpListener Lauschen zu beenden. Sie sind dafür verantwortlich, Ihre akzeptierten Verbindungen separat zu schließen.

Hinweis

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

Weitere Informationen

Gilt für:

Start(Int32)

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

Beginnt die Überwachung eingehender Verbindungsanforderungen mit einer maximalen Anzahl ausstehender Verbindungen.

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 Warteschlange für ausstehende Verbindungen.

Ausnahmen

Fehler beim Zugriff auf den Socket.

Der backlog-Parameter ist kleiner als 0 (null) oder übersteigt die maximale Anzahl zulässiger Verbindungen.

Der zugrunde liegende Socket ist NULL.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Start zum Lauschen auf eingehende Clientverbindungsversuche verwendet wird.

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }
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 den zugrunde liegenden Socket, bindet ihn an einen lokalen Endpunkt und lauscht auf eingehende Verbindungsversuche. Wenn eine Verbindungsanforderung empfangen wird, wird die Anforderung in die Warteschlange gestellt und auf zusätzliche Anforderungen gewartet, Start bis Sie die Stop -Methode aufrufen. Wenn TcpListener eine Verbindungsanforderung empfangen wird, nachdem die maximale Anzahl von Verbindungen bereits in die Warteschlange eingereiht wurde, wird auf dem Client eine SocketException ausgelöst.

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 eine zurück TcpClient , die Sie zum Senden und Empfangen von Daten verwenden können. Die AcceptSocket -Methode gibt eine Socket zurück, die Sie auch verwenden können. Wenn Ihre Anwendung nur synchrone E/A-Vorgänge erfordert, verwenden Sie .AcceptTcpClient Für eine detailliertere Verhaltenssteuerung verwenden Sie die AcceptSocket -Methode. Beide Methoden blockieren, bis eine Verbindungsanforderung in der Warteschlange verfügbar ist.

Verwenden Sie die Stop -Methode, um die -Methode zu schließen und das TcpListener Lauschen 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. In der Dokumentation zu API-Fehlercodes unter Windows Sockets, Version 2 finden Sie eine ausführliche Beschreibung des Fehlers.

Hinweis

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

Weitere Informationen

Gilt für: