TcpClient.Connect Método

Definição

Namespace:: System.Net.Sockets

Assemblies:: netstandard.dll, System.Net.Sockets.dll

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 nome do host e o número da porta especificados.

Sobrecargas

Nome	Description
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 endereço IP e o número da porta especificados.
Connect(IPAddress[], Int32)	Conecta o cliente a um host TCP remoto usando os endereços IP e o número da porta especificados.
Connect(String, Int32)	Conecta o cliente à porta especificada no host especificado.

Connect(IPEndPoint)

Origem:: TCPClient.cs

Origem:: TCPClient.cs

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 remoteEP parâmetro é null.

SocketException

Erro ao acessar o soquete.

ObjectDisposedException

O TcpClient está fechado.

Exemplos

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

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

Note

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.

Note

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Network Tracing in the .NET Framework.

Note

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

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Conecta o cliente a um host TCP remoto usando o endereço IP e o número da porta 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 host ao qual você pretende se conectar.

port: Int32

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

Exceções

ArgumentNullException

O address parâmetro é null.

ArgumentOutOfRangeException

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

SocketException

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

Note

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Network Tracing in the .NET Framework.

Note

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

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Conecta o cliente a um host TCP remoto usando os endereços IP e o número da porta 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 IPAddress matriz do host ao qual você pretende se conectar.

port: Int32

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

Exceções

ArgumentNullException

O ipAddresses parâmetro é null.

ArgumentOutOfRangeException

O número da porta não é válido.

SocketException

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

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

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

Note

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Network Tracing in the .NET Framework.

Note

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

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

ArgumentOutOfRangeException

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

SocketException

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

Note

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Network Tracing in the .NET Framework.

Confira também

Aplica-se a

Comentários

Esta página foi útil?