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.Connects the client to a remote TCP host using the specified host name and port number.

Sobrecargas

Connect(IPEndPoint)

Conecta o cliente a um host TCP remoto usando o ponto de extremidade de rede remoto especificado.Connects the client to a remote TCP host using the specified remote network endpoint.

Connect(IPAddress, Int32)

Conecta o cliente a um host TCP remoto usando o número da porta e o endereço IP especificados.Connects the client to a remote TCP host using the specified IP address and port number.

Connect(IPAddress[], Int32)

Conecta o cliente a um host TCP remoto usando o número da porta e endereços IP especificados.Connects the client to a remote TCP host using the specified IP addresses and port number.

Connect(String, Int32)

Conecta o cliente à porta especificada no host especificado.Connects the client to the specified port on the specified host.

Connect(IPEndPoint)

Conecta o cliente a um host TCP remoto usando o ponto de extremidade de rede remoto especificado.Connects the client to a remote TCP host using the specified remote network endpoint.

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.The IPEndPoint to which you intend to connect.

Exceções

O parâmetro remoteEp é null.The remoteEp parameter is null.

Ocorreu um erro ao acessar o soquete.An error occurred when accessing the socket.

O TcpClient está fechado.The TcpClient is closed.

Exemplos

O exemplo de código a seguir usa um IPEndPoint para se conectar com um host remoto.The following code example uses an IPEndPoint to connect with a remote host.

//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 .Call this method to establish a synchronous remote host connection to the specified 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.Before you call Connect, you must create an instance of the IPEndPoint class using an IP address and a port number. Use- IPEndPoint o como o remoteEP parâmetro.Use this IPEndPoint as the remoteEP parameter. O Connect método será bloqueado até que seja conectado ou falhe.The Connect method will block until it either connects or fails. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream .After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use isso NetworkStream para enviar e receber dados.Use this NetworkStream to send and receive data.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede no .NET FrameworkFor more information, see Network Tracing in the .NET Framework

Confira também

Aplica-se a

Connect(IPAddress, Int32)

Conecta o cliente a um host TCP remoto usando o número da porta e o endereço IP especificados.Connects the client to a remote TCP host using the specified IP address and port number.

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.The IPAddress of the host to which you intend to connect.

port
Int32

O número da porta à qual você pretende se conectar.The port number to which you intend to connect.

Exceções

O parâmetro address é null.The address parameter is null.

O port não está entre o MinPort e o MaxPort.The port is not between MinPort and MaxPort.

Ocorreu um erro ao acessar o soquete.An error occurred when accessing the socket.

TcpClient está fechado.TcpClient is closed.

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.The following code example uses an IP Address and port number to connect with a remote host.

//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 IPAddress número de porta e especificado.Call this method to establish a synchronous remote host connection to the specified IPAddress and port number. O Connect método será bloqueado até que seja conectado ou falhe.The Connect method will block until it either connects or fails. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream .After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use isso NetworkStream para enviar e receber dados.Use this NetworkStream to send and receive data.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a

Connect(IPAddress[], Int32)

Conecta o cliente a um host TCP remoto usando o número da porta e endereços IP especificados.Connects the client to a remote TCP host using the specified IP addresses and port number.

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.The IPAddress array of the host to which you intend to connect.

port
Int32

O número da porta à qual você pretende se conectar.The port number to which you intend to connect.

Exceções

O parâmetro ipAddresses é null.The ipAddresses parameter is null.

O número da porta é inválido.The port number is not valid.

Ocorreu um erro ao tentar acessar o soquete.An error occurred when attempting to access the socket.

O Socket foi fechado.The Socket has been closed.

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.A caller higher in the call stack does not have permission for the requested operation.

Este método é válido para soquetes que usam o sinalizador InterNetwork ou o sinalizador InterNetworkV6.This method is valid for sockets that use the InterNetwork flag or the InterNetworkV6 flag.

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.The following code example uses an IP Address and port number to connect with a remote host.

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.This method is typically used immediately after a call to the BeginGetHostAddresses method, which can return multiple IP addresses for a single 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 o número da porta.Call the Connect method to establish a synchronous remote host connection to the host specified by the array of IPAddress elements and the port number. O Connect método será bloqueado até que seja conectado ou falhe.The Connect method will block until it either connects or fails. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream .After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use isso NetworkStream para enviar e receber dados.Use this NetworkStream to send and receive data.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a

Connect(String, Int32)

Conecta o cliente à porta especificada no host especificado.Connects the client to the specified port on the specified host.

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.The DNS name of the remote host to which you intend to connect.

port
Int32

O número da porta do host remoto ao qual você pretende se conectar.The port number of the remote host to which you intend to connect.

Exceções

O parâmetro hostname é null.The hostname parameter is null.

O parâmetro port não está entre MinPort e MaxPort.The port parameter is not between MinPort and MaxPort.

Ocorreu um erro ao acessar o soquete.An error occurred when accessing the socket.

TcpClient está fechado.TcpClient is closed.

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.The following code example uses the host name and port number to connect with a remote host.

//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 de host e o número da porta especificados.Call this method to establish a synchronous remote host connection to the specified host name and port number. O Connect método será bloqueado até que seja conectado ou falhe.The Connect method will block until it either connects or fails. Depois de se conectar com o host remoto, use o GetStream método para obter o subjacente NetworkStream .After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use isso NetworkStream para enviar e receber dados.Use this NetworkStream to send and receive data.

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.If IPv6 is enabled and the Connect(String, Int32) method is called to connect to a host that resolves to both IPv6 and IPv4 addresses, the connection to the IPv6 address will be attempted first before the IPv4 address. 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.This may have the effect of delaying the time to establish the connection if the host is not listening on the IPv6 address.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a