TcpClient.ConnectAsync Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

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

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.ValueTask

Public Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parâ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

ValueTask

Uma tarefa que representa a operação de conexão assíncrona.

Exceções

ArgumentNullException

O parâmetro host é null.

ArgumentOutOfRangeException

O parâmetro port não está entre MinPort e MaxPort.

SocketException

Ocorreu um erro ao acessar o soquete.

ObjectDisposedException

TcpClient está fechado.

OperationCanceledException

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

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPAddress[], Int32, CancellationToken)

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.ValueTask

Public Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

Parâ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

ValueTask

Uma tarefa que representa a operação de conexão assíncrona.

Exceções

ArgumentNullException

O parâmetro ipAddresses é null.

ArgumentOutOfRangeException

O número da porta é inválido.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

SecurityException

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

NotSupportedException

Este método é válido para soquetes que usam o sinalizador InterNetwork ou o sinalizador InterNetworkV6.

OperationCanceledException

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

• TcpListener

ConnectAsync(IPAddress, Int32, CancellationToken)

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.ValueTask

Public Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parâ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

ValueTask

Uma tarefa que representa a operação de conexão assíncrona.

Exceções

ArgumentNullException

O parâmetro address é null.

ArgumentOutOfRangeException

O port não está entre o MinPort e o MaxPort.

SocketException

Ocorreu um erro ao acessar o soquete.

ObjectDisposedException

TcpClient está fechado.

OperationCanceledException

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

• GetStream()

ConnectAsync(String, Int32)

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.Task

Public Function ConnectAsync (host As String, port As Integer) As Task

Parâ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

Task

O objeto de tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

O parâmetro host é null.

ArgumentOutOfRangeException

O parâmetro port não está entre MinPort e MaxPort.

SocketException

Ocorreu um erro ao acessar o soquete.

ObjectDisposedException

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

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPEndPoint, CancellationToken)

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.ValueTask

Public Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTask

Parâ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

ValueTask

Uma tarefa que representa a operação assíncrona.

Exceções

OperationCanceledException

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).

ConnectAsync(IPAddress[], Int32)

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.Task

Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task

Parâmetros

addresses

IPAddress[]

A matriz IPAddress do host ao qual você pretende se conectar.

port

Int32

O número da porta à qual você pretende se conectar.

Retornos

Task

O objeto de tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

O parâmetro ipAddresses é null.

ArgumentOutOfRangeException

O número da porta é inválido.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

SecurityException

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

NotSupportedException

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

• TcpListener

ConnectAsync(IPAddress, Int32)

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.Task

Public Function ConnectAsync (address As IPAddress, port As Integer) As Task

Parâmetros

address

IPAddress

O IPAddress do host ao qual você pretende se conectar.

port

Int32

O número da porta à qual você pretende se conectar.

Retornos

Task

O objeto de tarefa que representa a operação assíncrona.

Exceções

ArgumentNullException

O parâmetro address é null.

ArgumentOutOfRangeException

O port não está entre o MinPort e o MaxPort.

SocketException

Ocorreu um erro ao acessar o soquete.

ObjectDisposedException

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

• GetStream()

ConnectAsync(IPEndPoint)

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.Task

Public Function ConnectAsync (remoteEP As IPEndPoint) As Task

Parâmetros

remoteEP

IPEndPoint

O IPEndPoint ao qual você pretende se conectar.

Retornos

Task

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).