Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Socket.Listen (Int32)

 

Data di pubblicazione: ottobre 2016

Posizioni un Socket in uno stato di attesa.

Spazio dei nomi:   System.Net.Sockets
Assembly:  System (in System.dll)

public void Listen(
	int backlog
)

Parametri

backlog
Type: System.Int32

La lunghezza massima della coda di connessioni in sospeso.

Exception Condition
SocketException

Si è verificato un errore durante il tentativo di accesso al socket. Per altre informazioni, vedere la sezione Osservazioni.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

Listen fa sì che orientato alla connessione Socket per ascoltare i tentativi di connessione in ingresso. Il backlog parametro specifica il numero di connessioni in ingresso che possono essere accodate per l'accettazione. Per determinare il numero massimo di connessioni è possibile specificare, recuperare il MaxConnections valore. Listen non è bloccata.

Se si riceve un SocketException, utilizzare il ErrorCode proprietà per ottenere il codice di errore specifico. Dopo avere ottenuto il codice, fare riferimento alla versione di Windows Sockets API errore codice documentazione 2 in MSDN library per una descrizione dettagliata dell'errore. Utilizzare Accept o BeginAccept per accettare una connessione dalla coda.

System_CAPS_noteNota

È necessario chiamare il Bind metodo prima di chiamare Listen, o Listen genererà un SocketException.

System_CAPS_noteNota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Tracciatura di rete in .NET Framework.

System_CAPS_noteNota

Il parametro backlog è limitato a valori diversi a seconda del sistema operativo. È possibile specificare un valore più elevato, ma il backlog sarà limitato in base al sistema operativo.

Nell'esempio di codice viene illustrato come utilizzare Socket per ascoltare le connessioni in ingresso.

       // create the socket
       Socket listenSocket = new Socket(AddressFamily.InterNetwork, 
                                        SocketType.Stream,
                                        ProtocolType.Tcp);

       // bind the listening socket to the port
IPAddress hostIP = (Dns.Resolve(IPAddress.Any.ToString())).AddressList[0];
       IPEndPoint ep = new IPEndPoint(hostIP, port);
       listenSocket.Bind(ep); 

       // start listening
       listenSocket.Listen(backlog);

Universal Windows Platform
Disponibile da 10
.NET Framework
Disponibile da 1.1
Windows Phone Silverlight
Disponibile da 8.0
Torna all'inizio
Mostra: