Socket.Listen Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Assembly:

System.dll, System.Net.Sockets.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Overload

Listen()	Colloca un Socket in uno stato di attesa.
Listen(Int32)	Colloca un Socket in uno stato di attesa.

Listen()

Colloca un Socket in uno stato di attesa.

public:
 void Listen();

public void Listen ();

member this.Listen : unit -> unit

Public Sub Listen ()

Commenti

La lunghezza massima della coda delle connessioni in sospeso viene determinata automaticamente.

Listen(Int32)

Colloca un Socket in uno stato di attesa.

public:
 void Listen(int backlog);

public void Listen (int backlog);

member this.Listen : int -> unit

Public Sub Listen (backlog As Integer)

Parametri

backlog

Int32

Lunghezza massima della coda delle connessioni in sospeso.

Eccezioni

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

Esempio

Nell'esempio di codice seguente viene Socket usato per restare in ascolto delle connessioni in ingresso.

// create the socket
Socket^ listenSocket = gcnew 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 = gcnew IPEndPoint( hostIP,port );
listenSocket->Bind( ep );

// start listening
listenSocket->Listen( backlog );

    // 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);

   ' create the socket
   Dim listenSocket As New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)
   
   ' bind the listening socket to the port
   Dim hostIP As IPAddress = Dns.Resolve(IPAddress.Any.ToString()).AddressList(0)
   Dim ep As New IPEndPoint(hostIP, port)
   listenSocket.Bind(ep)
   
   ' start listening
   listenSocket.Listen(backlog)
End Sub

Commenti

Listen fa sì che un oggetto orientato Socket alla connessione sia in ascolto dei 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 che è possibile specificare, recuperare il MaxConnections valore. Listen non blocca.

Se si riceve un SocketExceptionoggetto , utilizzare la ErrorCode proprietà per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore. Usare Accept o BeginAccept per accettare una connessione dalla coda.

Nota

È necessario chiamare il Bind metodo prima di chiamare Listeno Listen generare un'eccezione SocketException.

Nota

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

Nota

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

Vedi anche

• MaxConnections
• Accept()
• Bind(EndPoint)