Socket.Listen Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Sobrecargas

Listen()	Coloca um Socket em um estado de escuta.
Listen(Int32)	Coloca um Socket em um estado de escuta.

Listen()

Origem:

Socket.cs

Coloca um Socket em um estado de escuta.

public:
 void Listen();

public void Listen ();

member this.Listen : unit -> unit

Public Sub Listen ()

Comentários

O comprimento máximo da fila de conexões pendentes é determinado automaticamente.

Listen(Int32)

Origem:

Socket.cs

Coloca um Socket em um estado de escuta.

public:
 void Listen(int backlog);

public void Listen (int backlog);

member this.Listen : int -> unit

Public Sub Listen (backlog As Integer)

Parâmetros

backlog

Int32

O comprimento máximo da fila de conexões pendentes.

Exceções

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

Exemplos

O exemplo de código a seguir usa Socket para escutar conexões de entrada.

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

Comentários

Listen faz com que uma conexão seja orientada Socket a escutar tentativas de conexão de entrada. O backlog parâmetro especifica o número de conexões de entrada que podem ser enfileiradas para aceitação. Para determinar o número máximo de conexões que você pode especificar, recupere o MaxConnections valor. Listen não bloqueia.

Se você receber um SocketException, use a ErrorCode propriedade para obter o código de erro específico. Depois de obter esse código, consulte a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro. Use Accept ou BeginAccept para aceitar uma conexão da fila.

Observação

Você deve chamar o Bind método antes de chamar Listenou Listen gerará um SocketException.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede em .NET Framework.

Observação

O parâmetro de lista de pendências é limitado a valores diferentes, dependendo do sistema operacional. Você pode especificar um valor mais alto, mas a lista de pendências será limitada com base no sistema operacional.

Confira também

• MaxConnections
• Accept()
• Bind(EndPoint)