TcpClient.ConnectAsync 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.
Liga o cliente a um host TCP remoto usando o nome do host e o número de porta especificados como uma operação assíncrona.
Sobrecargas
| Name | Description |
|---|---|
| ConnectAsync(String, Int32, CancellationToken) |
Liga o cliente à porta TCP especificada no host especificado como uma operação assíncrona. |
| ConnectAsync(IPAddress[], Int32, CancellationToken) |
Liga o cliente a um host TCP remoto usando os endereços IP e o número de porta especificados como uma operação assíncrona. |
| ConnectAsync(IPAddress, Int32, CancellationToken) |
Liga o cliente a um host TCP remoto usando o endereço IP e número de porta especificados como uma operação assíncrona. |
| ConnectAsync(String, Int32) |
Liga o cliente à porta TCP especificada no host especificado como uma operação assíncrona. |
| ConnectAsync(IPEndPoint, CancellationToken) |
Liga o cliente a um host TCP remoto usando o endpoint especificado como uma operação assíncrona. |
| ConnectAsync(IPAddress[], Int32) |
Liga o cliente a um host TCP remoto usando os endereços IP e o número de porta especificados como uma operação assíncrona. |
| ConnectAsync(IPAddress, Int32) |
Liga o cliente a um host TCP remoto usando o endereço IP e número de porta especificados como uma operação assíncrona. |
| ConnectAsync(IPEndPoint) |
Liga o cliente a um host TCP remoto usando o endpoint especificado como uma operação assíncrona. |
ConnectAsync(String, Int32, CancellationToken)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Liga o cliente à porta TCP especificada no host especificado como uma operação assíncrona.
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync(string host, int port, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTaskParâmetros
- host
- String
O nome DNS do host remoto.
- port
- Int32
O número de porta do host remoto.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado para sinalizar a operação assíncrona deve ser cancelado.
Devoluções
Uma tarefa que representa a operação de ligação assíncrona.
Exceções
O host parâmetro é null.
Ocorreu um erro ao aceder ao soquete.
TcpClient está fechado.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Esta operação não vai bloquear. A tarefa devolvida será concluída após a ligação TCP estar estabelecida. Este método não bloqueia o thread que chama enquanto o pedido de ligação está em curso.
Chame este método para estabelecer uma ligação de host remoto síncrona ao nome do host e ao número de porta especificados como uma operação assíncrona. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto NetworkStream para enviar e receber dados.
Se o IPv6 estiver ativado e o ConnectAsync(String, Int32) método for chamado para se ligar a um host que resolve para os endereços IPv6 e IPv4, a ligação ao endereço IPv6 será tentada primeiro antes do endereço IPv4. Isto pode ter o efeito de atrasar o tempo para estabelecer a ligação se o anfitrião não estiver a ouvir no endereço IPv6.
Note
Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar o código de erro da API Windows Sockets versão 2 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.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(String, Int32).
Ver também
Aplica-se a
ConnectAsync(IPAddress[], Int32, CancellationToken)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Liga o cliente a um host TCP remoto usando os endereços IP e o número de porta especificados como uma operação assíncrona.
public:
System::Threading::Tasks::ValueTask ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync(System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTaskParâmetros
- addresses
- IPAddress[]
O array de endereços IP do host remoto.
- port
- Int32
O número de porta do host remoto.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado para sinalizar a operação assíncrona deve ser cancelado.
Devoluções
Uma tarefa que representa a operação de ligação assíncrona.
Exceções
O addresses parâmetro é null.
O número de porta não é válido.
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.
Este método é válido para soquetes que usam a InterNetwork flag ou a InterNetworkV6 flag.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Esta operação não vai bloquear. A tarefa devolvida será concluída após a ligação TCP estar estabelecida. Este método não bloqueia o thread que chama enquanto o pedido de ligação está em curso.
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. Chame este método para estabelecer uma ligação remota síncrona ao host especificado pelo array de endereços IP e pelo número da porta como uma operação assíncrona. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto NetworkStream para enviar e receber dados.
Note
Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar o código de erro da API Windows Sockets versão 2 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.
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.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(IPAddress[], Int32).
Ver também
Aplica-se a
ConnectAsync(IPAddress, Int32, CancellationToken)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Liga o cliente a um host TCP remoto usando o endereço IP e número de porta especificados como uma operação assíncrona.
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync(System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTaskParâmetros
- address
- IPAddress
O endereço IP do host remoto.
- port
- Int32
O número de porta do host remoto.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado para sinalizar a operação assíncrona deve ser cancelado.
Devoluções
Uma tarefa que representa a operação de ligação assíncrona.
Exceções
O address parâmetro é null.
Ocorreu um erro ao aceder ao soquete.
TcpClient está fechado.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Esta operação não vai bloquear. A tarefa devolvida será concluída após a ligação TCP estar estabelecida. Este método não bloqueia o thread que chama enquanto o pedido de ligação está em curso.
Chame este método para estabelecer uma ligação de host remoto síncrona ao endereço IP e número de porta especificados como uma operação assíncrona. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto NetworkStream para enviar e receber dados.
Note
Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar o código de erro da API Windows Sockets versão 2 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.
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.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(IPAddress, Int32).
Ver também
Aplica-se a
ConnectAsync(String, Int32)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Liga o cliente à porta TCP especificada no host especificado como uma operação assíncrona.
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);public System.Threading.Tasks.Task ConnectAsync(string host, int port);member this.ConnectAsync : string * int -> System.Threading.Tasks.TaskPublic Function ConnectAsync (host As String, port As Integer) As TaskParâmetros
- host
- String
O nome DNS do host remoto ao qual pretende ligar-se.
- port
- Int32
O número de porta do host remoto ao qual pretende ligar-se.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
O host parâmetro é null.
Ocorreu um erro ao aceder ao soquete.
TcpClient está fechado.
Observações
Esta operação não vai bloquear. O objeto Returns Task devolvido será concluído após a ligação TCP ter sido estabelecida. Este método não bloqueia o thread que chama enquanto o pedido de ligação está em curso.
Chame este método para estabelecer uma ligação de host remoto síncrona ao nome do host e ao número de porta especificados como uma operação assíncrona. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto NetworkStream para enviar e receber dados.
Se o IPv6 estiver ativado e o ConnectAsync(String, Int32) método for chamado para se ligar a um host que resolve para os endereços IPv6 e IPv4, a ligação ao endereço IPv6 será tentada primeiro antes do endereço IPv4. Isto pode ter o efeito de atrasar o tempo para estabelecer a ligação se o anfitrião não estiver a ouvir no endereço IPv6.
Note
Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar o código de erro da API Windows Sockets versão 2 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.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(String, Int32).
Ver também
Aplica-se a
ConnectAsync(IPEndPoint, CancellationToken)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Liga o cliente a um host TCP remoto usando o endpoint especificado como uma operação assíncrona.
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPEndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync(System.Net.IPEndPoint remoteEP, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTaskParâmetros
- remoteEP
- IPEndPoint
A IPEndPoint que pretende ligar-se.
- cancellationToken
- CancellationToken
Um token de cancelamento usado para propagar a notificação de que esta operação deveria ser cancelada.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Esta operação não vai bloquear. O objeto Returns Task devolvido será concluído após a ligação TCP ter sido estabelecida. Este método não bloqueia o thread que chama enquanto o pedido de ligação está em curso.
Chame este método para estabelecer uma ligação de host remoto síncrona ao especificado IPEndPoint. Antes de ligar Connect, deve criar uma instância da IPEndPoint classe usando um endereço IP e um número de porta. Usa isto IPEndPoint como parâmetro remoteEP . O Connect método bloqueia até conseguir ligar ou falhar. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto NetworkStream para enviar e receber dados.
Note
Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar o código de erro da API Windows Sockets versão 2 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.
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.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(IPEndPoint).
Aplica-se a
ConnectAsync(IPAddress[], Int32)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Liga o cliente a um host TCP remoto usando os endereços IP e o número de porta especificados como uma operação assíncrona.
public:
System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);public System.Threading.Tasks.Task ConnectAsync(System.Net.IPAddress[] addresses, int port);member this.ConnectAsync : System.Net.IPAddress[] * int -> System.Threading.Tasks.TaskPublic Function ConnectAsync (addresses As IPAddress(), port As Integer) As TaskParâmetros
- port
- Int32
O número de porta ao qual pretende ligar-se.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
O addresses parâmetro é null.
O número de porta não é válido.
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.
Este método é válido para soquetes que usam a InterNetwork flag ou a InterNetworkV6 flag.
Observações
Esta operação não vai bloquear. O objeto Returns Task devolvido será concluído após a ligação TCP ter sido estabelecida. Este método não bloqueia o thread que chama enquanto o pedido de ligação está em curso.
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. Chame este método para estabelecer uma ligação remota síncrona ao host especificado pelo array de IPAddress elementos e pelo número da porta como uma operação assíncrona. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto NetworkStream para enviar e receber dados.
Note
Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar o código de erro da API Windows Sockets versão 2 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.
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.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(IPAddress[], Int32).
Ver também
Aplica-se a
ConnectAsync(IPAddress, Int32)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Liga o cliente a um host TCP remoto usando o endereço IP e número de porta especificados como uma operação assíncrona.
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);public System.Threading.Tasks.Task ConnectAsync(System.Net.IPAddress address, int port);member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.TaskPublic Function ConnectAsync (address As IPAddress, port As Integer) As TaskParâmetros
- port
- Int32
O número de porta ao qual pretende ligar-se.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
O address parâmetro é null.
Ocorreu um erro ao aceder ao soquete.
TcpClient está fechado.
Observações
Esta operação não vai bloquear. O objeto Returns Task devolvido será concluído após a ligação TCP ter sido estabelecida. Este método não bloqueia o thread que chama enquanto o pedido de ligação está em curso.
Chame este método para estabelecer uma ligação síncrona remota ao host especificado IPAddress e ao número de porta como uma operação assíncrona. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto NetworkStream para enviar e receber dados.
Note
Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar o código de erro da API Windows Sockets versão 2 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.
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.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(IPAddress, Int32).
Ver também
Aplica-se a
ConnectAsync(IPEndPoint)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Liga o cliente a um host TCP remoto usando o endpoint especificado como uma operação assíncrona.
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPEndPoint ^ remoteEP);public System.Threading.Tasks.Task ConnectAsync(System.Net.IPEndPoint remoteEP);member this.ConnectAsync : System.Net.IPEndPoint -> System.Threading.Tasks.TaskPublic Function ConnectAsync (remoteEP As IPEndPoint) As TaskParâmetros
- remoteEP
- IPEndPoint
A IPEndPoint que pretende ligar-se.
Devoluções
Uma tarefa que representa a operação assíncrona.
Observações
Esta operação não vai bloquear. O objeto devolvido Task será concluído após a ligação TCP ter sido estabelecida. Este método não bloqueia o thread que chama enquanto o pedido de ligação está em curso.
Chame este método para estabelecer uma ligação de host remoto síncrona ao especificado IPEndPoint. Antes de ligar Connect, deve criar uma instância da IPEndPoint classe usando um endereço IP e um número de porta. Usa isto IPEndPoint como parâmetro remoteEP . O Connect método bloqueia até conseguir ligar ou falhar. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto NetworkStream para enviar e receber dados.
Note
Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar a documentação do código de erro da API Windows versão 2 do 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.
Note
Se receber uma NotSupportedException mensagem com a mensagem "Esta versão do protocolo não é suportada" ao usar o endereço IPv6, certifique-se de que ativou o IPv6 no construtor ao passar InterNetworkV6.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(IPEndPoint).
