TcpClient.ConnectAsync 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.
Conecta o cliente a um host TCP remoto usando o número da porta e o nome do host especificados como uma operação assíncrona.
Sobrecargas
| ConnectAsync(String, Int32, CancellationToken) |
Conecta o cliente à porta TCP especificada no host especificado como uma operação assíncrona. |
| ConnectAsync(IPAddress[], Int32, CancellationToken) |
Conecta o cliente a um host de TCP remoto usando o número da porta e os endereços IP especificados como uma operação assíncrona. |
| ConnectAsync(IPAddress, Int32, CancellationToken) |
Conecta o cliente a um host TCP remoto usando o número da porta e o endereço IP especificados como uma operação assíncrona. |
| ConnectAsync(String, Int32) |
Conecta o cliente à porta TCP especificada no host especificado como uma operação assíncrona. |
| ConnectAsync(IPEndPoint, CancellationToken) |
Conecta o cliente a um host TCP remoto usando o ponto de extremidade especificado como uma operação assíncrona. |
| ConnectAsync(IPAddress[], Int32) |
Conecta o cliente a um host de TCP remoto usando o número da porta e os endereços IP especificados como uma operação assíncrona. |
| ConnectAsync(IPAddress, Int32) |
Conecta o cliente a um host TCP remoto usando o número da porta e o endereço IP especificados como uma operação assíncrona. |
| ConnectAsync(IPEndPoint) |
Conecta o cliente a um host TCP remoto usando o ponto de extremidade especificado como uma operação assíncrona. |
ConnectAsync(String, Int32, CancellationToken)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Conecta 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 da porta do host remoto.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.
Retornos
Uma tarefa que representa a operação de conexão assíncrona.
Exceções
O parâmetro host é null.
Ocorreu um erro ao acessar o soquete.
TcpClient está fechado.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esta operação não será bloqueada. A tarefa retornada será concluída depois que a conexão TCP for estabelecida. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.
Chame esse método para estabelecer uma conexão de host remoto síncrona com o nome do host e o número da porta especificados como uma operação assíncrona. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream. Use isso NetworkStream para enviar e receber dados.
Se o IPv6 estiver habilitado e o ConnectAsync(String, Int32) método for chamado para se conectar a um host que seja resolvido para endereços IPv6 e IPv4, a conexão com o endereço IPv6 será tentada primeiro antes do endereço IPv4. Isso pode ter o efeito de atrasar o tempo para estabelecer a conexão se o host não estiver escutando no endereço IPv6.
Observação
Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(String, Int32).
Confira também
Aplica-se a
ConnectAsync(IPAddress[], Int32, CancellationToken)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Conecta o cliente a um host de TCP remoto usando o número da porta e os endereços IP 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[]
A matriz de endereços IP do host remoto.
- port
- Int32
O número da porta do host remoto.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.
Retornos
Uma tarefa que representa a operação de conexão assíncrona.
Exceções
O parâmetro ipAddresses é null.
O número da porta é inválido.
Ocorreu um 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.
Este método é válido para soquetes que usam o sinalizador InterNetwork ou o sinalizador InterNetworkV6.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esta operação não será bloqueada. A tarefa retornada será concluída depois que a conexão TCP for estabelecida. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.
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. Chame esse método para estabelecer uma conexão de host remoto síncrona com o host especificado pela matriz de endereços IP e o número da porta como uma operação assíncrona. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream. Use isso NetworkStream para enviar e receber dados.
Observação
Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(IPAddress[], Int32).
Confira também
Aplica-se a
ConnectAsync(IPAddress, Int32, CancellationToken)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Conecta o cliente a um host TCP remoto usando o número da porta e o endereço IP 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 da porta do host remoto.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.
Retornos
Uma tarefa que representa a operação de conexão assíncrona.
Exceções
O parâmetro address é null.
Ocorreu um erro ao acessar o soquete.
TcpClient está fechado.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esta operação não será bloqueada. A tarefa retornada será concluída depois que a conexão TCP for estabelecida. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.
Chame esse método para estabelecer uma conexão de host remoto síncrona com o endereço IP e o número da porta especificados como uma operação assíncrona. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream. Use isso NetworkStream para enviar e receber dados.
Observação
Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(IPAddress, Int32).
Confira também
Aplica-se a
ConnectAsync(String, Int32)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Conecta 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 você pretende se conectar.
- port
- Int32
O número da porta do host remoto ao qual você pretende se conectar.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O parâmetro host é null.
Ocorreu um erro ao acessar o soquete.
TcpClient está fechado.
Comentários
Esta operação não será bloqueada. O objeto Returns Task retornado será concluído depois que a conexão TCP for estabelecida. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.
Chame esse método para estabelecer uma conexão de host remoto síncrona com o nome do host e o número da porta especificados como uma operação assíncrona. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream. Use isso NetworkStream para enviar e receber dados.
Se o IPv6 estiver habilitado e o ConnectAsync(String, Int32) método for chamado para se conectar a um host que seja resolvido para endereços IPv6 e IPv4, a conexão com o endereço IPv6 será tentada primeiro antes do endereço IPv4. Isso pode ter o efeito de atrasar o tempo para estabelecer a conexão se o host não estiver escutando no endereço IPv6.
Observação
Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(String, Int32).
Confira também
Aplica-se a
ConnectAsync(IPEndPoint, CancellationToken)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Conecta o cliente a um host TCP remoto usando o ponto de extremidade 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
O IPEndPoint ao qual você pretende se conectar.
- cancellationToken
- CancellationToken
Um token de cancelamento usado para propagar a notificação de que essa operação deve ser cancelada.
Retornos
Uma tarefa que representa a operação assíncrona.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esta operação não será bloqueada. O objeto Returns Task retornado será concluído depois que a conexão TCP for estabelecida. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.
Chame esse método para estabelecer uma conexão de host remoto síncrona com o especificado IPEndPoint. Antes de chamar Connect, você deve criar uma instância da IPEndPoint classe usando um endereço IP e um número de porta. Use isso IPEndPoint como o remoteEP parâmetro . O Connect método será bloqueado até que ele se conecte ou falhe. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream. Use isso NetworkStream para enviar e receber dados.
Observação
Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(IPEndPoint).
Aplica-se a
ConnectAsync(IPAddress[], Int32)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Conecta o cliente a um host de TCP remoto usando o número da porta e os endereços IP 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 da porta à qual você pretende se conectar.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O parâmetro ipAddresses é null.
O número da porta é inválido.
Ocorreu um 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.
Este método é válido para soquetes que usam o sinalizador InterNetwork ou o sinalizador InterNetworkV6.
Comentários
Esta operação não será bloqueada. O objeto Returns Task retornado será concluído depois que a conexão TCP for estabelecida. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.
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. Chame esse método para estabelecer uma conexão de host remoto síncrona com o host especificado pela matriz de elementos e o número da IPAddress porta como uma operação assíncrona. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream. Use isso NetworkStream para enviar e receber dados.
Observação
Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(IPAddress[], Int32).
Confira também
Aplica-se a
ConnectAsync(IPAddress, Int32)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Conecta o cliente a um host TCP remoto usando o número da porta e o endereço IP 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 da porta à qual você pretende se conectar.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O parâmetro address é null.
Ocorreu um erro ao acessar o soquete.
TcpClient está fechado.
Comentários
Esta operação não será bloqueada. O objeto Returns Task retornado será concluído depois que a conexão TCP for estabelecida. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.
Chame esse método para estabelecer uma conexão de host remoto síncrona com o número da porta e especificado IPAddress como uma operação assíncrona. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream. Use isso NetworkStream para enviar e receber dados.
Observação
Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(IPAddress, Int32).
Confira também
Aplica-se a
ConnectAsync(IPEndPoint)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
Conecta o cliente a um host TCP remoto usando o ponto de extremidade 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
O IPEndPoint ao qual você pretende se conectar.
Retornos
Uma tarefa que representa a operação assíncrona.
Comentários
Esta operação não será bloqueada. O objeto retornado Task será concluído depois que a conexão TCP for estabelecida. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.
Chame esse método para estabelecer uma conexão de host remoto síncrona com o especificado IPEndPoint. Antes de chamar Connect, você deve criar uma instância da IPEndPoint classe usando um endereço IP e um número de porta. Use isso IPEndPoint como o remoteEP parâmetro . O Connect método será bloqueado até que ele se conecte ou falhe. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream. Use isso NetworkStream para enviar e receber dados.
Observação
Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.
Observação
Se você receber um NotSupportedException com a mensagem "Esta versão de protocolo não tem suporte" ao usar o endereço IPv6, verifique se você habilitou o IPv6 no construtor passando InterNetworkV6.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(IPEndPoint).
