TcpListener.Start Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Começa a escutar as solicitações de conexão recebidas.

Sobrecargas

Start()	Começa a escutar as solicitações de conexão recebidas.
Start(Int32)	Começa a detectar solicitações de conexão recebidas com um número máximo conexões pendentes.

Start()

Origem:

TCPListener.cs

Começa a escutar as solicitações de conexão recebidas.

public:
 void Start();

public void Start ();

member this.Start : unit -> unit

Public Sub Start ()

Exceções

SocketException

Use a propriedade ErrorCode para obter o código de erro específico. Quando tiver obtido esse código, você poderá consultar a documentação de códigos de erro da API da versão 2 do Windows Sockets para obter uma descrição detalhada do erro.

Exemplos

O exemplo de código a seguir demonstra como Start é usado para escutar tentativas de conexão de cliente de entrada.

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }

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

Comentários

O Start método inicializa o subjacente Socket, associa-o a um ponto de extremidade local e escuta as tentativas de conexão de entrada. Se uma solicitação de conexão for recebida, o Start método enfileirará a solicitação e continuará escutando solicitações adicionais até que você chame o Stop método . Se TcpListener receber uma solicitação de conexão depois de já ter enfileirado o número máximo de conexões, ele gerará um SocketException no cliente.

Para remover uma conexão da fila de conexão de entrada, use o AcceptTcpClient método ou o AcceptSocket método . O AcceptTcpClient método removerá uma conexão da fila e retornará uma TcpClient que você pode usar para enviar e receber dados. O AcceptSocket método retornará um Socket que você pode usar para fazer o mesmo. Se o aplicativo exigir apenas E/S síncrona, use AcceptTcpClient. Para obter um controle comportamental mais detalhado, use AcceptSocket. Esses dois métodos são bloqueados até que uma solicitação de conexão esteja disponível na fila.

Use o Stop método para fechar e TcpListener parar de escutar. Você é responsável por fechar suas conexões aceitas separadamente.

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 no .NET Framework.

Confira também

• Listen(Int32)
• Bind(EndPoint)
• AcceptTcpClient()
• Stop()

Start(Int32)

Origem:

TCPListener.cs

Começa a detectar solicitações de conexão recebidas com um número máximo conexões pendentes.

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 conexões pendentes.

Exceções

SocketException

Ocorreu um erro ao acessar o soquete.

ArgumentOutOfRangeException

O parâmetro backlog é menor que zero ou excede o número máximo de conexões permitidas.

InvalidOperationException

O Socket subjacente é nulo.

Exemplos

O exemplo de código a seguir demonstra como Start é usado para escutar tentativas de conexão de cliente de entrada.

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }

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

Comentários

O Start método inicializa o subjacente Socket, associa-o a um ponto de extremidade local e escuta as tentativas de conexão de entrada. Se uma solicitação de conexão for recebida, Start enfileirará a solicitação e continuará escutando solicitações adicionais até que você chame o Stop método . Se TcpListener receber uma solicitação de conexão depois de já ter enfileirado o número máximo de conexões, ele gerará um SocketException no cliente.

Para remover uma conexão da fila de conexão de entrada, use o AcceptTcpClient método ou o AcceptSocket método . O AcceptTcpClient método removerá uma conexão da fila e retornará uma TcpClient que você pode usar para enviar e receber dados. O AcceptSocket método retornará um Socket que você pode usar para fazer o mesmo. Se o aplicativo exigir apenas E/S síncrona, use o AcceptTcpClient. Para um controle comportamental mais detalhado, use AcceptSocket o método . Esses dois métodos são bloqueados até que uma solicitação de conexão esteja disponível na fila.

Use o Stop método para fechar e TcpListener parar de escutar. Você é responsável por fechar suas conexões aceitas separadamente.

Observação

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

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 no .NET Framework.

Confira também

• Listen(Int32)
• Bind(EndPoint)
• AcceptTcpClient()
• AcceptSocket()
• Stop()