TcpClient.BeginConnect Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia uma solicitação assíncrona para uma conexão de host remoto.
Sobrecargas
| Nome | Description |
|---|---|
| BeginConnect(IPAddress, Int32, AsyncCallback, Object) |
Inicia uma solicitação assíncrona para uma conexão de host remoto. O host remoto é especificado por um IPAddress e um número de porta (Int32). |
| BeginConnect(IPAddress[], Int32, AsyncCallback, Object) |
Inicia uma solicitação assíncrona para uma conexão de host remoto. O host remoto é especificado por uma IPAddress matriz e um número de porta (Int32). |
| BeginConnect(String, Int32, AsyncCallback, Object) |
Inicia uma solicitação assíncrona para uma conexão de host remoto. O host remoto é especificado por um nome de host (String) e um número de porta (Int32). |
BeginConnect(IPAddress, Int32, AsyncCallback, Object)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
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);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 da porta do host remoto.
- requestCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a ser invocado quando a operação for concluída.
- state
- Object
Um objeto definido pelo usuário que contém informações sobre a operação de conexão. Esse objeto é passado para o requestCallback delegado quando a operação é concluída.
Retornos
Um IAsyncResult objeto que faz referência à conexão assíncrona.
Exceções
O address parâmetro é null.
Erro ao tentar acessar o soquete.
O Socket foi fechado.
Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.
O número da porta não é válido.
Comentários
A operação assíncrona BeginConnect deve ser concluída chamando o EndConnect método. Normalmente, o método é invocado pelo asyncCallback delegado.
Esse método não é bloqueado até que a operação seja concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas do Connect método.
Para obter informações detalhadas sobre como usar o modelo de programação assíncrona, consulte Chamando métodos síncronos de forma assíncrona.
Note
Se você receber NotSupportedException com mensagem This protocol version is not supported ao usar o endereço IPv6, verifique se habilitou o IPv6 no construtor passando InterNetworkV6.
Aplica-se a
BeginConnect(IPAddress[], Int32, AsyncCallback, Object)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
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);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 da porta dos hosts remotos.
- requestCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a ser invocado quando a operação for concluída.
- state
- Object
Um objeto definido pelo usuário que contém informações sobre a operação de conexão. Esse objeto é passado para o requestCallback delegado quando a operação é concluída.
Retornos
Um IAsyncResult objeto que faz referência à conexão assíncrona.
Exceções
O addresses parâmetro é null.
Erro ao tentar acessar o soquete.
O Socket foi fechado.
Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.
O número da porta não é válido.
Comentários
A operação assíncrona BeginConnect deve ser concluída chamando o EndConnect método. Normalmente, o método é invocado pelo asyncCallback delegado.
Esse método não é bloqueado até que a operação seja concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas do Connect método.
Para obter informações detalhadas sobre como usar o modelo de programação assíncrona, consulte Chamando métodos síncronos de forma assíncrona.
Esse método normalmente é usado imediatamente após uma chamada para o BeginGetHostAddresses método, que pode retornar vários endereços IP para um único host.
Note
Se você receber NotSupportedException com mensagem This protocol version is not supported ao usar o endereço IPv6, verifique se habilitou o IPv6 no construtor passando InterNetworkV6.
Aplica-se a
BeginConnect(String, Int32, AsyncCallback, Object)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
public:
IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);public IAsyncResult BeginConnect(string host, int port, AsyncCallback? requestCallback, 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 host remoto.
- port
- Int32
O número da porta do host remoto.
- requestCallback
- AsyncCallback
Um AsyncCallback delegado que faz referência ao método a ser invocado quando a operação for concluída.
- state
- Object
Um objeto definido pelo usuário que contém informações sobre a operação de conexão. Esse objeto é passado para o requestCallback delegado quando a operação é concluída.
Retornos
Um IAsyncResult objeto que faz referência à conexão assíncrona.
Exceções
O host parâmetro é null.
Erro ao tentar acessar o soquete.
O Socket foi fechado.
Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.
O número da porta não é válido.
Comentários
A operação assíncrona BeginConnect deve ser concluída chamando o EndConnect método. Normalmente, o método é invocado pelo asyncCallback delegado.
Esse método não é bloqueado até que a operação seja concluída. Para bloquear até que a operação seja concluída, use uma das sobrecargas do Connect método.
Para obter informações detalhadas sobre como usar o modelo de programação assíncrona, consulte Chamando métodos síncronos de forma assíncrona.
