TcpListener.Start Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.