TcpListener.Start Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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()
Beginnt die Überwachung von eingehenden Verbindungsanforderungen.
public:
void Start();public void Start ();member this.Start : unit -> unitPublic 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 sie verwendet wird, um eingehende Clientverbindungsversuche zu überwachen.
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 die zugrunde liegende SocketMethode, bindet sie an einen lokalen Endpunkt und überwacht eingehende Verbindungsversuche. Wenn eine Verbindungsanforderung empfangen wird, wird die Methode die Start Anforderung in die Warteschlange stellen und die Überwachung weiterer Anforderungen fortsetzen, 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, wird ein Client ausgelöst SocketException .
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 TcpClient zurück, die Sie zum Senden und Empfangen von Daten verwenden können. Die AcceptSocket Methode gibt eine Socket zurück, die Sie verwenden können, um dasselbe zu tun. Wenn Ihre Anwendung nur synchrone E/A erfordert, verwenden Sie AcceptTcpClient. Verwenden Sie AcceptSocketzur detaillierteren 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
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter "Netzwerkablaufverfolgung" im .NET Framework.
Siehe auch
Gilt für
Start(Int32)
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 -> unitPublic 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 sie verwendet wird, um eingehende Clientverbindungsversuche zu überwachen.
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 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 weiterer 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, wird sie auf SocketException dem Client 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 TcpClient zurück, die Sie zum Senden und Empfangen von Daten verwenden können. Die AcceptSocket Methode gibt eine Socket zurück, die Sie verwenden können, um dasselbe zu tun. Wenn Ihre Anwendung nur synchrone I/O erfordert, verwenden Sie die AcceptTcpClient. Verwenden Sie die Methode, um detailliertere Verhaltenssteuerungen zu erhalten 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. 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.