Condividi tramite


TcpListener.Start Metodo

Definizione

Avvia l'ascolto delle richieste di connessione in ingresso.

Overload

Nome Descrizione
Start()

Avvia l'ascolto delle richieste di connessione in ingresso.

Start(Int32)

Avvia l'ascolto delle richieste di connessione in ingresso con un numero massimo di connessioni in sospeso.

Start()

Origine:
TCPListener.cs
Origine:
TCPListener.cs
Origine:
TCPListener.cs
Origine:
TCPListener.cs
Origine:
TCPListener.cs

Avvia l'ascolto delle richieste di connessione in ingresso.

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

Eccezioni

Utilizzare la ErrorCode proprietà per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Esempio

Nell'esempio di codice seguente viene illustrato come Start viene usato per l'ascolto dei tentativi di connessione client in ingresso.

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

Commenti

Il Start metodo inizializza l'oggetto sottostante Socket, lo associa a un endpoint locale e rimane in ascolto dei tentativi di connessione in ingresso. Se viene ricevuta una richiesta di connessione, il Start metodo accoderà la richiesta e continuerà ad ascoltare richieste aggiuntive fino a quando non si chiama il Stop metodo . Se TcpListener riceve una richiesta di connessione dopo aver già accodato il numero massimo di connessioni, verrà generata un'eccezione SocketException sul client.

Per rimuovere una connessione dalla coda di connessione in ingresso, usare il AcceptTcpClient metodo o il AcceptSocket metodo . Il AcceptTcpClient metodo rimuoverà una connessione dalla coda e restituirà un oggetto TcpClient che è possibile usare per inviare e ricevere dati. Il AcceptSocket metodo restituirà un oggetto Socket che è possibile utilizzare per eseguire la stessa operazione. Se l'applicazione richiede solo operazioni di I/O sincrone, usare AcceptTcpClient. Per un controllo comportamentale più dettagliato, usare AcceptSocket. Entrambi questi metodi bloccano fino a quando non è disponibile una richiesta di connessione nella coda.

Usare il Stop metodo per chiudere e arrestare l'ascolto TcpListener . L'utente è responsabile della chiusura delle connessioni accettate separatamente.

Annotazioni

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Vedi anche

Si applica a

Start(Int32)

Origine:
TCPListener.cs
Origine:
TCPListener.cs
Origine:
TCPListener.cs
Origine:
TCPListener.cs
Origine:
TCPListener.cs

Avvia l'ascolto delle richieste di connessione in ingresso con un numero massimo di connessioni in sospeso.

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

Parametri

backlog
Int32

Lunghezza massima della coda di connessioni in sospeso.

Eccezioni

Errore durante l'accesso al socket.

Il backlog parametro è minore di zero o supera il numero massimo di connessioni consentite.

L'oggetto sottostante Socket è Null.

Esempio

Nell'esempio di codice seguente viene illustrato come Start viene usato per l'ascolto dei tentativi di connessione client in ingresso.

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

Commenti

Il Start metodo inizializza l'oggetto sottostante Socket, lo associa a un endpoint locale e rimane in ascolto dei tentativi di connessione in ingresso. Se viene ricevuta una richiesta di connessione, Start accoderà la richiesta e continuerà ad ascoltare richieste aggiuntive fino a quando non si chiama il Stop metodo . Se TcpListener riceve una richiesta di connessione dopo che ha già accodato il numero massimo di connessioni, verrà generata un'eccezione SocketException sul client.

Per rimuovere una connessione dalla coda di connessione in ingresso, usare il AcceptTcpClient metodo o il AcceptSocket metodo . Il AcceptTcpClient metodo rimuoverà una connessione dalla coda e restituirà un oggetto TcpClient che è possibile usare per inviare e ricevere dati. Il AcceptSocket metodo restituirà un oggetto Socket che è possibile utilizzare per eseguire la stessa operazione. Se l'applicazione richiede solo operazioni di I/O sincrone, usare .AcceptTcpClient Per un controllo comportamentale più dettagliato, usare il AcceptSocket metodo . Entrambi questi metodi bloccano fino a quando non è disponibile una richiesta di connessione nella coda.

Usare il Stop metodo per chiudere e arrestare l'ascolto TcpListener . L'utente è responsabile della chiusura delle connessioni accettate separatamente.

Annotazioni

Usare la SocketException.ErrorCode proprietà per ottenere il codice di errore specifico e fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Annotazioni

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Vedi anche

Si applica a