TcpListener.Start Methode

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

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

Beginnt die Überwachung von eingehenden Verbindungsanforderungen.

public:
 void Start();

public void Start ();

member this.Start : unit -> unit

Public Sub Start ()

Ausnahmen

SocketException

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 im .NET Framework.

Weitere Informationen

• Listen(Int32)
• Bind(EndPoint)
• AcceptTcpClient()
• Stop()

Start(Int32)

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

SocketException

Fehler beim Zugriff auf den Socket.

ArgumentOutOfRangeException

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

InvalidOperationException

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 im .NET Framework.

Weitere Informationen

• Listen(Int32)
• Bind(EndPoint)
• AcceptTcpClient()
• AcceptSocket()
• Stop()