TcpClient.ConnectAsync Método

Definição

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.Connects the client to a remote TCP host using the specified host name and port number as an asynchronous operation.

Sobrecargas

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.Connects the client to a remote TCP host using the specified IP addresses and port number as an asynchronous operation.

ConnectAsync(String, Int32, CancellationToken)

Conecta o cliente à porta TCP especificada no host especificado como uma operação assíncrona.Connects the client to the specified TCP port on the specified host as an asynchronous operation.

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.Connects the client to a remote TCP host using the specified IP address and port number as an asynchronous operation.

ConnectAsync(String, Int32)

Conecta o cliente à porta TCP especificada no host especificado como uma operação assíncrona.Connects the client to the specified TCP port on the specified host as an asynchronous operation.

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.Connects the client to a remote TCP host using the specified IP addresses and port number as an asynchronous operation.

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.Connects the client to a remote TCP host using the specified IP address and port number as an asynchronous operation.

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.Connects the client to a remote TCP host using the specified IP addresses and port number as an asynchronous operation.

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.The array of IP address of the remote host.

port
Int32

O número da porta do host remoto.The port number of the remote host.

cancellationToken
CancellationToken

Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.A cancellation token that can be used to signal the asynchronous operation should be canceled.

Retornos

ValueTask

Uma tarefa que representa a operação de conexão assíncrona.A task that represents the asynchronous connection operation.

Exceções

O parâmetro ipAddresses é null.The ipAddresses parameter is null.

O número da porta é inválido.The port number is not valid.

Ocorreu um erro ao tentar acessar o soquete.An error occurred when attempting to access the socket.

O Socket foi fechado.The Socket has been closed.

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.A caller higher in the call stack does not have permission for the requested operation.

Este método é válido para soquetes que usam o sinalizador InterNetwork ou o sinalizador InterNetworkV6.This method is valid for sockets that use the InterNetwork flag or the InterNetworkV6 flag.

Comentários

Esta operação não será bloqueada.This operation will not block. A tarefa retornada será concluída depois que a conexão TCP tiver sido estabelecida.The returned task will complete after the TCP connection has been established. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.This method does not block the calling thread while the connection request is underway.

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.This method is typically used immediately after a call to the BeginGetHostAddresses method, which can return multiple IP addresses for a single 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.Call this method to establish a synchronous remote host connection to the host specified by the array of IP addresses and the port number as an asynchronous operation. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream .After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use isso NetworkStream para enviar e receber dados.Use this NetworkStream to send and receive data.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a

ConnectAsync(String, Int32, CancellationToken)

Conecta o cliente à porta TCP especificada no host especificado como uma operação assíncrona.Connects the client to the specified TCP port on the specified host as an asynchronous operation.

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.The DNS name of the remote host.

port
Int32

O número da porta do host remoto.The port number of the remote host.

cancellationToken
CancellationToken

Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.A cancellation token that can be used to signal the asynchronous operation should be canceled.

Retornos

ValueTask

Uma tarefa que representa a operação de conexão assíncrona.A task that represents the asynchronous connection operation.

Exceções

O parâmetro hostname é null.The hostname parameter is null.

O parâmetro port não está entre MinPort e MaxPort.The port parameter is not between MinPort and MaxPort.

Ocorreu um erro ao acessar o soquete.An error occurred when accessing the socket.

TcpClient está fechado.TcpClient is closed.

Comentários

Esta operação não será bloqueada.This operation will not block. A tarefa retornada será concluída depois que a conexão TCP tiver sido estabelecida.The returned task will complete after the TCP connection has been established. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.This method does not block the calling thread while the connection request is underway.

Chame esse método para estabelecer uma conexão de host remoto síncrona com o nome de host e o número da porta especificados como uma operação assíncrona.Call this method to establish a synchronous remote host connection to the specified host name and port number as an asynchronous operation. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream .After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use isso NetworkStream para enviar e receber dados.Use this NetworkStream to send and receive data.

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.If IPv6 is enabled and the ConnectAsync(String, Int32) method is called to connect to a host that resolves to both IPv6 and IPv4 addresses, the connection to the IPv6 address will be attempted first before the IPv4 address. 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.This may have the effect of delaying the time to establish the connection if the host is not listening on the IPv6 address.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a

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.Connects the client to a remote TCP host using the specified IP address and port number as an asynchronous operation.

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.The IP address of the remote host.

port
Int32

O número da porta do host remoto.The port number of the remote host.

cancellationToken
CancellationToken

Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.A cancellation token that can be used to signal the asynchronous operation should be canceled.

Retornos

ValueTask

Uma tarefa que representa a operação de conexão assíncrona.A task that represents the asynchronous connection operation.

Exceções

O parâmetro address é null.The address parameter is null.

O port não está entre o MinPort e o MaxPort.The port is not between MinPort and MaxPort.

Ocorreu um erro ao acessar o soquete.An error occurred when accessing the socket.

TcpClient está fechado.TcpClient is closed.

Comentários

Esta operação não será bloqueada.This operation will not block. A tarefa retornada será concluída depois que a conexão TCP tiver sido estabelecida.The returned task will complete after the TCP connection has been established. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.This method does not block the calling thread while the connection request is underway.

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.Call this method to establish a synchronous remote host connection to the specified IP address and port number as an asynchronous operation. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream .After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use isso NetworkStream para enviar e receber dados.Use this NetworkStream to send and receive data.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a

ConnectAsync(String, Int32)

Conecta o cliente à porta TCP especificada no host especificado como uma operação assíncrona.Connects the client to the specified TCP port on the specified host as an asynchronous operation.

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.The DNS name of the remote host to which you intend to connect.

port
Int32

O número da porta do host remoto ao qual você pretende se conectar.The port number of the remote host to which you intend to connect.

Retornos

Task

O objeto de tarefa que representa a operação assíncrona.The task object representing the asynchronous operation.

Exceções

O parâmetro hostname é null.The hostname parameter is null.

O parâmetro port não está entre MinPort e MaxPort.The port parameter is not between MinPort and MaxPort.

Ocorreu um erro ao acessar o soquete.An error occurred when accessing the socket.

TcpClient está fechado.TcpClient is closed.

Comentários

Esta operação não será bloqueada.This operation will not block. O objeto de retornos retornado Task será concluído após a conexão TCP ter sido estabelecida.The returned Returns Task object will complete after the TCP connection has been established. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.This method does not block the calling thread while the connection request is underway.

Chame esse método para estabelecer uma conexão de host remoto síncrona com o nome de host e o número da porta especificados como uma operação assíncrona.Call this method to establish a synchronous remote host connection to the specified host name and port number as an asynchronous operation. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream .After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use isso NetworkStream para enviar e receber dados.Use this NetworkStream to send and receive data.

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.If IPv6 is enabled and the ConnectAsync(String, Int32) method is called to connect to a host that resolves to both IPv6 and IPv4 addresses, the connection to the IPv6 address will be attempted first before the IPv4 address. 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.This may have the effect of delaying the time to establish the connection if the host is not listening on the IPv6 address.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a

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.Connects the client to a remote TCP host using the specified IP addresses and port number as an asynchronous operation.

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.The IPAddress array of the host to which you intend to connect.

port
Int32

O número da porta à qual você pretende se conectar.The port number to which you intend to connect.

Retornos

Task

O objeto de tarefa que representa a operação assíncrona.The task object representing the asynchronous operation.

Exceções

O parâmetro ipAddresses é null.The ipAddresses parameter is null.

O número da porta é inválido.The port number is not valid.

Ocorreu um erro ao tentar acessar o soquete.An error occurred when attempting to access the socket.

O Socket foi fechado.The Socket has been closed.

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.A caller higher in the call stack does not have permission for the requested operation.

Este método é válido para soquetes que usam o sinalizador InterNetwork ou o sinalizador InterNetworkV6.This method is valid for sockets that use the InterNetwork flag or the InterNetworkV6 flag.

Comentários

Esta operação não será bloqueada.This operation will not block. O objeto de retornos retornado Task será concluído após a conexão TCP ter sido estabelecida.The returned Returns Task object will complete after the TCP connection has been established. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.This method does not block the calling thread while the connection request is underway.

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.This method is typically used immediately after a call to the BeginGetHostAddresses method, which can return multiple IP addresses for a single host. Chame esse método para estabelecer uma conexão de host remoto síncrona com o host especificado pela matriz de IPAddress elementos e o número da porta como uma operação assíncrona.Call this method to establish a synchronous remote host connection to the host specified by the array of IPAddress elements and the port number as an asynchronous operation. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream .After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use isso NetworkStream para enviar e receber dados.Use this NetworkStream to send and receive data.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a

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.Connects the client to a remote TCP host using the specified IP address and port number as an asynchronous operation.

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.The IPAddress of the host to which you intend to connect.

port
Int32

O número da porta à qual você pretende se conectar.The port number to which you intend to connect.

Retornos

Task

O objeto de tarefa que representa a operação assíncrona.The task object representing the asynchronous operation.

Exceções

O parâmetro address é null.The address parameter is null.

O port não está entre o MinPort e o MaxPort.The port is not between MinPort and MaxPort.

Ocorreu um erro ao acessar o soquete.An error occurred when accessing the socket.

TcpClient está fechado.TcpClient is closed.

Comentários

Esta operação não será bloqueada.This operation will not block. O objeto de retornos retornado Task será concluído após a conexão TCP ter sido estabelecida.The returned Returns Task object will complete after the TCP connection has been established. Esse método não bloqueia o thread de chamada enquanto a solicitação de conexão está em andamento.This method does not block the calling thread while the connection request is underway.

Chame esse método para estabelecer uma conexão de host remoto síncrona com o IPAddress número de porta e especificado como uma operação assíncrona.Call this method to establish a synchronous remote host connection to the specified IPAddress and port number as an asynchronous operation. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream .After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use isso NetworkStream para enviar e receber dados.Use this NetworkStream to send and receive data.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a