Compartilhar via


TcpClient.Connect Método

Definição

Conecta o cliente a um host TCP remoto usando o número da porta e o nome do host especificados.

Sobrecargas

Connect(IPEndPoint)

Conecta o cliente a um host TCP remoto usando o ponto de extremidade de rede remoto especificado.

Connect(IPAddress, Int32)

Conecta o cliente a um host TCP remoto usando o número da porta e o endereço IP especificados.

Connect(IPAddress[], Int32)

Conecta o cliente a um host TCP remoto usando o número da porta e endereços IP especificados.

Connect(String, Int32)

Conecta o cliente à porta especificada no host especificado.

Connect(IPEndPoint)

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

Conecta o cliente a um host TCP remoto usando o ponto de extremidade de rede remoto especificado.

public:
 void Connect(System::Net::IPEndPoint ^ remoteEP);
public void Connect (System.Net.IPEndPoint remoteEP);
member this.Connect : System.Net.IPEndPoint -> unit
Public Sub Connect (remoteEP As IPEndPoint)

Parâmetros

remoteEP
IPEndPoint

O IPEndPoint ao qual você pretende se conectar.

Exceções

O parâmetro remoteEp é null.

Ocorreu um erro ao acessar o soquete.

Exemplos

O exemplo de código a seguir usa um IPEndPoint para se conectar a um host remoto.

//Uses a remote end point to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
tcpClient->Connect( ipEndPoint );
//Uses a remote endpoint to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint (ipAddress, 11004);

tcpClient.Connect (ipEndPoint);
'Uses a remote endpoint to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)

tcpClient.Connect(ipEndPoint)

Comentários

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-o 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 mensagem This protocol version is not supported ao usar o endereço IPv6, verifique se habilitou o IPv6 no construtor passando InterNetworkV6.

Confira também

Aplica-se a

Connect(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.

public:
 void Connect(System::Net::IPAddress ^ address, int port);
public void Connect (System.Net.IPAddress address, int port);
member this.Connect : System.Net.IPAddress * int -> unit
Public Sub Connect (address As IPAddress, port As Integer)

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.

Exceções

O parâmetro address é null.

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

Ocorreu um erro ao acessar o soquete.

Exemplos

O exemplo de código a seguir usa um endereço IP e um número de porta para se conectar com um host remoto.

//Uses the IP address and port number to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
tcpClient->Connect( ipAddress, 11003 );
//Uses the IP address and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];

tcpClient.Connect (ipAddress, 11003);
'Uses the IP address and port number to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
tcpClient.Connect(ipAddress, 11003)

Comentários

Chame esse método para estabelecer uma conexão de host remoto síncrona com o número de porta e especificado IPAddress . 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 mensagem This protocol version is not supported ao usar o endereço IPv6, verifique se habilitou o IPv6 no construtor passando InterNetworkV6.

Confira também

Aplica-se a

Connect(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 endereços IP especificados.

public:
 void Connect(cli::array <System::Net::IPAddress ^> ^ ipAddresses, int port);
public void Connect (System.Net.IPAddress[] ipAddresses, int port);
member this.Connect : System.Net.IPAddress[] * int -> unit
Public Sub Connect (ipAddresses As IPAddress(), port As Integer)

Parâmetros

ipAddresses
IPAddress[]

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

port
Int32

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

Exceções

O parâmetro ipAddresses é null.

O número da porta é inválido.

Ocorreu um erro ao tentar acessar o soquete.

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

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

Exemplos

O exemplo de código a seguir usa um endereço IP e um número de porta para se conectar com um host remoto.

static void DoConnect( String^ host, int port )
{
   // Connect to the specified host.
   TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
   array<IPAddress^>^IPAddresses = Dns::GetHostAddresses( host );
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->Connect( IPAddresses, port );
   Console::WriteLine( "Connection established" );
}
static void DoConnect(string host, int port)
{
    // Connect to the specified host.
    TcpClient t = new TcpClient(AddressFamily.InterNetwork);

    IPAddress[] IPAddresses = Dns.GetHostAddresses(host);

    Console.WriteLine("Establishing connection to {0}", host);
    t.Connect(IPAddresses, port);

    Console.WriteLine("Connection established");
}

Comentários

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 o Connect método para estabelecer uma conexão de host remoto síncrona com o host especificado pela matriz de elementos e pelo número da IPAddress porta. 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 mensagem This protocol version is not supported ao usar o endereço IPv6, verifique se habilitou o IPv6 no construtor passando InterNetworkV6.

Confira também

Aplica-se a

Connect(String, Int32)

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

Conecta o cliente à porta especificada no host especificado.

public:
 void Connect(System::String ^ hostname, int port);
public void Connect (string hostname, int port);
member this.Connect : string * int -> unit
Public Sub Connect (hostname As String, port As Integer)

Parâmetros

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

Exceções

O parâmetro hostname é null.

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

Ocorreu um erro ao acessar o soquete.

Exemplos

O exemplo de código a seguir usa o nome do host e o número da porta para se conectar com um host remoto.

//Uses a host name and port number to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
tcpClient->Connect( "www.contoso.com", 11002 );
//Uses a host name and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
tcpClient.Connect ("www.contoso.com", 11002);
'Uses a host name and port number to establish a socket connection.
Dim tcpClient As New TcpClient()

   tcpClient.Connect("www.contoso.com", 11002)

Comentários

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

Se iPv6 estiver habilitado e o Connect(String, Int32) método for chamado para se conectar a um host que resolva 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.

Confira também

Aplica-se a