Compartilhar via


TcpClient.BeginConnect Método

Definição

Inicia uma solicitação assíncrona para uma conexão de host remoto.

Sobrecargas

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 da 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 matriz IPAddress e um número da 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 do host (String) e um número da porta (Int32).

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Origem:
TCPClient.cs
Origem:
TCPClient.cs
Origem:
TCPClient.cs

Inicia uma solicitação assíncrona para uma conexão de host remoto. O host remoto é especificado por um IPAddress e um número da porta (Int32).

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 -> IAsyncResult
Public Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

address
IPAddress

O IPAddress do host remoto.

port
Int32

O número da porta do host remoto.

requestCallback
AsyncCallback

Um delegado AsyncCallback que faz referência ao método a ser invocado quando a operação é 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 delegado requestCallback quando a operação é concluída.

Retornos

Um objeto IAsyncResult que faz referência à conexão assíncrona.

Exceções

O parâmetro address é null.

Ocorreu um erro ao tentar acessar o soquete.

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.

O número da porta é invá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 de 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.

Observação

Se você receber NotSupportedException com a 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

Inicia uma solicitação assíncrona para uma conexão de host remoto. O host remoto é especificado por uma matriz IPAddress e um número da porta (Int32).

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 -> IAsyncResult
Public Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

addresses
IPAddress[]

Pelo menos um IPAddress que designa os hosts remotos.

port
Int32

O número da porta dos hosts remotos.

requestCallback
AsyncCallback

Um delegado AsyncCallback que faz referência ao método a ser invocado quando a operação é 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 delegado requestCallback quando a operação é concluída.

Retornos

Um objeto IAsyncResult que faz referência à conexão assíncrona.

Exceções

O parâmetro addresses é null.

Ocorreu um erro ao tentar acessar o soquete.

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.

O número da porta é invá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 de 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.

Observação

Se você receber NotSupportedException com a 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

Inicia uma solicitação assíncrona para uma conexão de host remoto. O host remoto é especificado por um nome do host (String) e um número da porta (Int32).

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 -> IAsyncResult
Public Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

host
String

O nome do host remoto.

port
Int32

O número da porta do host remoto.

requestCallback
AsyncCallback

Um delegado AsyncCallback que faz referência ao método a ser invocado quando a operação é 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 delegado requestCallback quando a operação é concluída.

Retornos

Um objeto IAsyncResult que faz referência à conexão assíncrona.

Exceções

O parâmetro host é null.

Ocorreu um erro ao tentar acessar o soquete.

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.

O número da porta é invá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 de 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.

Aplica-se a