TcpClient.Connect Método

Definição

Espaço de Nomes:: System.Net.Sockets

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

Assemblagem:: System.Net.Sockets.dll

Assemblagem:: System.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Liga o cliente a um host TCP remoto usando o nome de host e o número de porta especificados.

Sobrecargas

Name	Description
Connect(IPEndPoint)	Liga o cliente a um host TCP remoto usando o endpoint da rede remota especificado.
Connect(IPAddress, Int32)	Liga o cliente a um host TCP remoto usando o endereço IP e o número de porta especificados.
Connect(IPAddress[], Int32)	Liga o cliente a um host TCP remoto usando os endereços IP e o número de porta especificados.
Connect(String, Int32)	Liga o cliente à porta especificada no host especificado.

Connect(IPEndPoint)

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Liga o cliente a um host TCP remoto usando o endpoint da rede remota 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

A IPEndPoint que pretende ligar-se.

Exceções

ArgumentNullException

O remoteEP parâmetro é null.

SocketException

Ocorreu um erro ao aceder ao soquete.

ObjectDisposedException

Está TcpClient fechado.

Exemplos

O seguinte exemplo de código usa um IPEndPoint para se ligar a 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)

Observações

Chame este método para estabelecer uma ligação de host remoto síncrona ao especificado IPEndPoint. Antes de ligar Connect, deve criar uma instância da IPEndPoint classe usando um endereço IP e um número de porta. Usa isto IPEndPoint como parâmetro remoteEP . O Connect método bloqueia até conseguir ligar ou falhar. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto NetworkStream para enviar e receber dados.

Note

Se receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter este código, pode consultar o código de erro da API Windows Sockets versão 2 para 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 mais informações, consulte Rastreamento de Rede no .NET Framework.

Note

Se receber NotSupportedException com mensagem This protocol version is not supported enquanto usa o endereço IPv6, certifique-se de que ativou o IPv6 no construtor ao passar InterNetworkV6.

Ver também

Aplica-se a

Connect(IPAddress, Int32)

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Liga o cliente a um host TCP remoto usando o endereço IP e o número de 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 do anfitrião a quem pretende ligar-se.

port: Int32

O número de porta ao qual pretende ligar-se.

Exceções

ArgumentNullException

O address parâmetro é null.

ArgumentOutOfRangeException

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

SocketException

Ocorreu um erro ao aceder ao soquete.

ObjectDisposedException

TcpClient está fechado.

Exemplos

O exemplo de código seguinte utiliza um endereço IP e um número de porta para se ligar a 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)

Observações

Chame este método para estabelecer uma ligação de host remoto síncrona ao número especificado IPAddress e à porta. O Connect método bloqueia até conseguir ligar ou falhar. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto 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 mais informações, consulte Rastreamento de Rede no .NET Framework.

Note

Se receber NotSupportedException com mensagem This protocol version is not supported enquanto usa o endereço IPv6, certifique-se de que ativou o IPv6 no construtor ao passar InterNetworkV6.

Ver também

GetStream()

Aplica-se a

Connect(IPAddress[], Int32)

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Liga o cliente a um host TCP remoto usando os endereços IP e o número de 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[]

O IPAddress array do host ao qual pretende ligar-se.

port: Int32

O número de porta ao qual pretende ligar-se.

Exceções

ArgumentNullException

O ipAddresses parâmetro é null.

ArgumentOutOfRangeException

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

SocketException

Ocorreu um erro ao tentar aceder ao soquete.

ObjectDisposedException

O Socket local foi encerrado.

SecurityException

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

NotSupportedException

Este método é válido para soquetes que usam a InterNetwork flag ou a InterNetworkV6 flag.

Exemplos

O exemplo de código seguinte utiliza um endereço IP e um número de porta para se ligar a 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");
}

Observações

Este método é normalmente usado imediatamente após uma chamada ao BeginGetHostAddresses método, podendo devolver múltiplos endereços IP para um único host. Chame o Connect método para estabelecer uma ligação remota síncrona ao host especificado pelo array de IPAddress elementos e pelo número da porta. O Connect método bloqueia até conseguir ligar ou falhar. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto 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 mais informações, consulte Rastreamento de Rede no .NET Framework.

Note

Se receber NotSupportedException com mensagem This protocol version is not supported enquanto usa o endereço IPv6, certifique-se de que ativou o IPv6 no construtor ao passar InterNetworkV6.

Ver também

TcpListener

Aplica-se a

Connect(String, Int32)

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Origem:: TCPClient.cs

Liga 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 pretende ligar-se.

port: Int32

O número de porta do host remoto ao qual pretende ligar-se.

Exceções

ArgumentNullException

O hostname parâmetro é null.

ArgumentOutOfRangeException

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

SocketException

Ocorreu um erro ao aceder ao soquete.

ObjectDisposedException

TcpClient está fechado.

Exemplos

O exemplo de código seguinte utiliza o nome do host e o número de porta para se ligar a 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)

Observações

Chame este método para estabelecer uma ligação remota síncrona ao host nome e número de porta especificados. O Connect método bloqueia até conseguir ligar ou falhar. Depois de se ligar ao host remoto, utilize o GetStream método para obter o valor subjacente NetworkStream. Use isto NetworkStream para enviar e receber dados.

Se o IPv6 estiver ativado e o Connect(String, Int32) método for chamado para se ligar a um host que resolve para os endereços IPv6 e IPv4, a ligação ao endereço IPv6 será tentada primeiro antes do endereço IPv4. Isto pode ter o efeito de atrasar o tempo para estabelecer a ligação se o anfitrião não estiver a ouvir no endereço IPv6.

Note

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Rastreamento de Rede no .NET Framework.

Ver também

Aplica-se a

Comentários

Esta página foi útil?