TcpListener.Start Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Begint te luisteren naar binnenkomende verbindingsaanvragen.
Overloads
| Name | Description |
|---|---|
| Start() |
Begint te luisteren naar binnenkomende verbindingsaanvragen. |
| Start(Int32) |
Begint te luisteren naar binnenkomende verbindingsaanvragen met een maximum aantal in behandeling zijnde verbindingen. |
Start()
- Bron:
- TCPListener.cs
- Bron:
- TCPListener.cs
- Bron:
- TCPListener.cs
- Bron:
- TCPListener.cs
- Bron:
- TCPListener.cs
Begint te luisteren naar binnenkomende verbindingsaanvragen.
public:
void Start();public void Start();member this.Start : unit -> unitPublic Sub Start ()Uitzonderingen
Gebruik de ErrorCode eigenschap om de specifieke foutcode op te halen. Wanneer u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe Start wordt gebruikt om te luisteren naar binnenkomende clientverbindingspogingen.
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
Opmerkingen
De Start methode initialiseert de onderliggende Socketgegevens, verbindt deze met een lokaal eindpunt en luistert naar binnenkomende verbindingspogingen. Als er een verbindingsaanvraag wordt ontvangen, wordt de aanvraag in de Start wachtrij geplaatst en wordt verder geluisterd naar aanvullende aanvragen totdat u de Stop methode aanroept. Als TcpListener er een verbindingsaanvraag wordt ontvangen nadat deze al het maximum aantal verbindingen in de wachtrij heeft geplaatst, wordt er een SocketException op de client verzonden.
Als u een verbinding uit de wachtrij voor binnenkomende verbindingen wilt verwijderen, gebruikt u de AcceptTcpClient methode of de AcceptSocket methode. De AcceptTcpClient methode verwijdert een verbinding uit de wachtrij en retourneert een TcpClient verbinding die u kunt gebruiken om gegevens te verzenden en te ontvangen. De AcceptSocket methode retourneert een Socket methode die u kunt gebruiken om hetzelfde te doen. Als uw toepassing alleen synchrone I/O vereist, gebruikt u AcceptTcpClient. Gebruik AcceptSocketvoor meer gedetailleerde gedragsbeheersing. Beide methoden blokkeren totdat een verbindingsaanvraag beschikbaar is in de wachtrij.
Gebruik de Stop methode om het TcpListener luisteren te sluiten en te stoppen. U bent verantwoordelijk voor het afzonderlijk sluiten van uw geaccepteerde verbindingen.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.
Zie ook
Van toepassing op
Start(Int32)
- Bron:
- TCPListener.cs
- Bron:
- TCPListener.cs
- Bron:
- TCPListener.cs
- Bron:
- TCPListener.cs
- Bron:
- TCPListener.cs
Begint te luisteren naar binnenkomende verbindingsaanvragen met een maximum aantal in behandeling zijnde verbindingen.
public:
void Start(int backlog);public void Start(int backlog);member this.Start : int -> unitPublic Sub Start (backlog As Integer)Parameters
- backlog
- Int32
De maximale lengte van de wachtrij voor in behandeling zijnde verbindingen.
Uitzonderingen
Er is een fout opgetreden tijdens het openen van de socket.
De backlog parameter is kleiner dan nul of overschrijdt het maximum aantal toegestane verbindingen.
De onderliggende Socket waarde is null.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe Start wordt gebruikt om te luisteren naar binnenkomende clientverbindingspogingen.
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
Opmerkingen
De Start methode initialiseert de onderliggende Socketgegevens, verbindt deze met een lokaal eindpunt en luistert naar binnenkomende verbindingspogingen. Als een verbindingsaanvraag wordt ontvangen, Start plaatst u de aanvraag in de wachtrij en luistert u verder naar aanvullende aanvragen totdat u de Stop methode aanroept. Als TcpListener er een verbindingsaanvraag wordt ontvangen nadat deze al het maximum aantal verbindingen in de wachtrij heeft geplaatst, wordt er een SocketException op de client verzonden.
Als u een verbinding uit de wachtrij voor binnenkomende verbindingen wilt verwijderen, gebruikt u de AcceptTcpClient methode of de AcceptSocket methode. De AcceptTcpClient methode verwijdert een verbinding uit de wachtrij en retourneert een TcpClient verbinding die u kunt gebruiken om gegevens te verzenden en te ontvangen. De AcceptSocket methode retourneert een Socket methode die u kunt gebruiken om hetzelfde te doen. Als voor uw toepassing alleen synchrone I/O is vereist, gebruikt u de AcceptTcpClient. Gebruiksmethode AcceptSocket voor meer gedetailleerde gedragscontrole. Beide methoden blokkeren totdat een verbindingsaanvraag beschikbaar is in de wachtrij.
Gebruik de Stop methode om het TcpListener luisteren te sluiten en te stoppen. U bent verantwoordelijk voor het afzonderlijk sluiten van uw geaccepteerde verbindingen.
Note
Gebruik de eigenschap SocketException.ErrorCode om de specifieke foutcode te verkrijgen en raadpleeg de Windows API-foutcode sockets versie 2 voor een gedetailleerde beschrijving van de fout.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.
