TcpListener.Start Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.