TcpClient.Connect Método

Referência

Definição

Namespace:: System.Net.Sockets

Assembly:: System.Net.Sockets.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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.

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

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

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

GetStream()

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

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

TcpListener

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

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

TcpClient.Connect Método

Definição

Sobrecargas

Connect(IPEndPoint)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Connect(IPAddress, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Connect(IPAddress[], Int32)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Connect(String, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Comentários

Recursos adicionais