TcpClient.Connect Método

  • Referência

Definição

Namespace:
System.Net.Sockets
Assembly:
System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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

ArgumentNullException

O parâmetro remoteEp é null.

SocketException

Ocorreu um erro ao acessar o soquete.

ObjectDisposedException

O TcpClient está fechado.

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

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

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.

Exemplos

O exemplo de código a seguir usa um endereço IP e um número de porta para se conectar a 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 da 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 a 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

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.

Exemplos

O exemplo de código a seguir usa um endereço IP e um número de porta para se conectar a 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 IPAddress elementos e pelo número da 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 a 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

ArgumentNullException

O parâmetro hostname é 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.

Exemplos

O exemplo de código a seguir usa o nome do host e o número da porta para se conectar a 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 o IPv6 estiver habilitado e o Connect(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.

Confira também

Aplica-se a