TcpClient.BeginConnect 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.
Inicia um pedido assíncrono para uma ligação remota ao host.
Sobrecargas
| Name | Description |
|---|---|
| BeginConnect(IPAddress, Int32, AsyncCallback, Object) |
Inicia um pedido assíncrono para uma ligação remota ao host. O host remoto é especificado por um IPAddress e um número de porta (Int32). |
| BeginConnect(IPAddress[], Int32, AsyncCallback, Object) |
Inicia um pedido assíncrono para uma ligação remota ao host. O host remoto é especificado por um IPAddress array e um número de porta (Int32). |
| BeginConnect(String, Int32, AsyncCallback, Object) |
Inicia um pedido assíncrono para uma ligação remota ao host. O host remoto é especificado por um nome de host (String) e um número de porta (Int32). |
BeginConnect(IPAddress, Int32, AsyncCallback, Object)
public:
IAsyncResult ^ BeginConnect(System::Net::IPAddress ^ address, int port, AsyncCallback ^ requestCallback, System::Object ^ state);public IAsyncResult BeginConnect(System.Net.IPAddress address, int port, AsyncCallback requestCallback, object state);member this.BeginConnect : System.Net.IPAddress * int * AsyncCallback * obj -> IAsyncResultPublic Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResultParâmetros
- port
- Int32
O número de porta do host remoto.
- requestCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a operação estiver completa.
- state
- Object
Um objeto definido pelo utilizador que contém informação sobre a operação de ligação. Este objeto é passado ao requestCallback delegado quando a operação está concluída.
Devoluções
Um IAsyncResult objeto que faz referência à ligação assíncrona.
Exceções
O address parâmetro é null.
Ocorreu um erro ao tentar aceder ao soquete.
O Socket local foi encerrado.
Um chamador mais acima na pilha de chamadas não tem permissão para a operação solicitada.
O número de porta não é válido.
Observações
A operação assíncrona BeginConnect deve ser concluída chamando o EndConnect método. Normalmente, o método é invocado pelo asyncCallback delegado.
Este método não bloqueia até que a operação seja concluída. Para bloquear até a operação terminar, use uma das Connect sobrecargas de métodos.
Para informações detalhadas sobre a utilização do modelo de programação assíncrona, veja Chamar Métodos Síncronos Assíncronos.
Note
Se receber NotSupportedException com mensagem This protocol version is not supported enquanto usa o endereço IPv6, certifique-se de que ativou o IPv6 no construtor ao passar InterNetworkV6.
Aplica-se a
BeginConnect(IPAddress[], Int32, AsyncCallback, Object)
public:
IAsyncResult ^ BeginConnect(cli::array <System::Net::IPAddress ^> ^ addresses, int port, AsyncCallback ^ requestCallback, System::Object ^ state);public IAsyncResult BeginConnect(System.Net.IPAddress[] addresses, int port, AsyncCallback requestCallback, object state);member this.BeginConnect : System.Net.IPAddress[] * int * AsyncCallback * obj -> IAsyncResultPublic Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResultParâmetros
- port
- Int32
O número de porta dos hosts remotos.
- requestCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a operação estiver completa.
- state
- Object
Um objeto definido pelo utilizador que contém informação sobre a operação de ligação. Este objeto é passado ao requestCallback delegado quando a operação está concluída.
Devoluções
Um IAsyncResult objeto que faz referência à ligação assíncrona.
Exceções
O addresses parâmetro é null.
Ocorreu um erro ao tentar aceder ao soquete.
O Socket local foi encerrado.
Um chamador mais acima na pilha de chamadas não tem permissão para a operação solicitada.
O número de porta não é válido.
Observações
A operação assíncrona BeginConnect deve ser concluída chamando o EndConnect método. Normalmente, o método é invocado pelo asyncCallback delegado.
Este método não bloqueia até que a operação seja concluída. Para bloquear até a operação terminar, use uma das Connect sobrecargas de métodos.
Para informações detalhadas sobre a utilização do modelo de programação assíncrona, veja Chamar Métodos Síncronos Assíncronos.
Este método é normalmente usado imediatamente após uma chamada ao BeginGetHostAddresses método, podendo devolver múltiplos endereços IP para um único host.
Note
Se receber NotSupportedException com mensagem This protocol version is not supported enquanto usa o endereço IPv6, certifique-se de que ativou o IPv6 no construtor ao passar InterNetworkV6.
Aplica-se a
BeginConnect(String, Int32, AsyncCallback, Object)
public:
IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);public IAsyncResult BeginConnect(string host, int port, AsyncCallback requestCallback, object state);member this.BeginConnect : string * int * AsyncCallback * obj -> IAsyncResultPublic Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResultParâmetros
- host
- String
O nome do anfitrião remoto.
- port
- Int32
O número de porta do host remoto.
- requestCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a invocar quando a operação estiver completa.
- state
- Object
Um objeto definido pelo utilizador que contém informação sobre a operação de ligação. Este objeto é passado ao requestCallback delegado quando a operação está concluída.
Devoluções
Um IAsyncResult objeto que faz referência à ligação assíncrona.
Exceções
O host parâmetro é null.
Ocorreu um erro ao tentar aceder ao soquete.
O Socket local foi encerrado.
Um chamador mais acima na pilha de chamadas não tem permissão para a operação solicitada.
O número de porta não é válido.
Observações
A operação assíncrona BeginConnect deve ser concluída chamando o EndConnect método. Normalmente, o método é invocado pelo asyncCallback delegado.
Este método não bloqueia até que a operação seja concluída. Para bloquear até a operação terminar, use uma das Connect sobrecargas de métodos.
Para informações detalhadas sobre a utilização do modelo de programação assíncrona, veja Chamar Métodos Síncronos Assíncronos.