TcpListener.Start Método

Definição

Começa a ouvir pedidos de ligação recebidos.

Sobrecargas

Name Descrição
Start()

Começa a ouvir pedidos de ligação recebidos.

Start(Int32)

Começa a ouvir pedidos de ligação recebidos com um número máximo de ligação pendente.

Start()

Origem:
TCPListener.cs
Origem:
TCPListener.cs
Origem:
TCPListener.cs
Origem:
TCPListener.cs
Origem:
TCPListener.cs

Começa a ouvir pedidos de ligação recebidos.

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

Exceções

Use a ErrorCode propriedade para obter o código de erro específico. Quando obter este código, pode consultar a documentação do código de erro da API Windows Sockets versão 2 para uma descrição detalhada do erro.

Exemplos

O exemplo de código seguinte demonstra como Start é usado para ouvir tentativas de ligação de clientes recebidas.

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

Observações

O Start método inicializa o subjacente Socket, liga-o a um ponto final local e ouve tentativas de ligação recebidas. Se for recebido um pedido de ligação, o Start método colocará o pedido em fila e continuará a ouvir pedidos adicionais até que chame o Stop método. Se TcpListener receber um pedido de ligação depois de já ter enfileirado o número máximo de ligações, irá lançar um SocketException a ao cliente.

Para remover uma ligação da fila de ligação de entrada, use ou o AcceptTcpClient método ou o AcceptSocket método. O AcceptTcpClient método remove uma ligação da fila e devolve uma TcpClient que podes usar para enviar e receber dados. O AcceptSocket método devolve um Socket que pode usar para fazer o mesmo. Se a sua aplicação só requer I/O síncrona, use AcceptTcpClient. Para um controlo comportamental mais detalhado, use AcceptSocket. Ambos os métodos bloqueiam até que um pedido de ligação esteja disponível na fila.

Use o Stop método para fechar e TcpListener parar de ouvir. És responsável por fechar as tuas ligações aceites separadamente.

Note

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Rastreamento de Rede no .NET Framework.

Ver também

Aplica-se a

Start(Int32)

Origem:
TCPListener.cs
Origem:
TCPListener.cs
Origem:
TCPListener.cs
Origem:
TCPListener.cs
Origem:
TCPListener.cs

Começa a ouvir pedidos de ligação recebidos com um número máximo de ligação pendente.

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

Parâmetros

backlog
Int32

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

Exceções

Ocorreu um erro ao aceder ao soquete.

O backlog parâmetro é inferior a zero ou excede o número máximo de ligações permitidas.

O subjacente Socket é nulo.

Exemplos

O exemplo de código seguinte demonstra como Start é usado para ouvir tentativas de ligação de clientes recebidas.

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

Observações

O Start método inicializa o subjacente Socket, liga-o a um ponto final local e ouve tentativas de ligação recebidas. Se for recebido um pedido de ligação, Start irá colocar o pedido em fila e continuar a ouvir pedidos adicionais até chamar o Stop método. Se TcpListener receber um pedido de ligação depois de já ter colocado o número máximo de ligações na fila, irá lançar um SocketException a no cliente.

Para remover uma ligação da fila de ligação de entrada, use ou o AcceptTcpClient método ou o AcceptSocket método. O AcceptTcpClient método remove uma ligação da fila e devolve uma TcpClient que podes usar para enviar e receber dados. O AcceptSocket método devolve um Socket que pode usar para fazer o mesmo. Se a sua aplicação só requer I/O síncrona, use o AcceptTcpClientarquivo . Para um controlo comportamental mais detalhado, use AcceptSocket o método. Ambos os métodos bloqueiam até que um pedido de ligação esteja disponível na fila.

Use o Stop método para fechar e TcpListener parar de ouvir. És responsável por fechar as tuas ligações aceites separadamente.

Note

Use a propriedade SocketException.ErrorCode para obter o código de erro específico e consulte a documentação do código de erro da API Windows versão 2 dos Sockets para uma descrição detalhada do erro.

Note

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Rastreamento de Rede no .NET Framework.

Ver também

Aplica-se a