Compartilhar via

TcpListener.Start Método

Definição

Namespace:
System.Net.Sockets
Assemblies:
netstandard.dll, System.Net.Sockets.dll
Assembly:
System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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

Sobrecargas

Nome Description
Start()

Começa a escutar solicitações de conexão de entrada.
Start(Int32)

Começa a escutar solicitações de conexão de entrada com um número máximo de conexão pendente.

Start()

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

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

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

Exceções

SocketException

Use a ErrorCode propriedade para obter o código de erro específico. Quando você tiver obtido esse código, poderá consultar a documentação do código de erro da API do Windows Sockets versão 2 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 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, ela lançará 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 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 ouvir. Você é responsável por fechar suas conexões aceitas separadamente.

Observação

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

Confira 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 escutar solicitações de conexão de entrada com um número máximo de conexã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 conexões pendentes.

Exceções

SocketException

Erro ao acessar o soquete.

ArgumentOutOfRangeException

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

InvalidOperationException

O subjacente Socket é 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 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 lançará 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 precisar apenas de 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 ouvir. Você é responsável por fechar suas conexões aceitas separadamente.

Observação

Use a SocketException.ErrorCode propriedade para obter o código de erro específico e 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.

Observação

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

Confira também

Aplica-se a