Comparteix a través de


TcpClient.Connect Método

Definición

Conecta el cliente a un host TCP remoto con el nombre de host y el número de puerto especificados.

Sobrecargas

Connect(IPEndPoint)

Conecta el cliente a un host TCP remoto con el punto de conexión de red remoto especificado.

Connect(IPAddress, Int32)

Conecta el cliente a un host TCP remoto con la dirección IP y el número de puerto especificados.

Connect(IPAddress[], Int32)

Conecta el cliente a un host TCP remoto con las direcciones IP y el número de puerto que se especificaron.

Connect(String, Int32)

Conecta el cliente al puerto especificado en el host especificado.

Connect(IPEndPoint)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Conecta el cliente a un host TCP remoto con el punto de conexión de red 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

IPEndPoint con el que desea conectar.

Excepciones

El parámetro remoteEp es null.

Se produjo un error al acceder al socket.

La clase TcpClient está cerrada.

Ejemplos

En el ejemplo de código siguiente se usa para IPEndPoint conectarse con un 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)

Comentarios

Llame a este método para establecer una conexión de host remoto sincrónica con el especificado IPEndPoint. Antes de llamar a Connect, debe crear una instancia de la IPEndPoint clase mediante una dirección IP y un número de puerto. Úselo IPEndPoint como remoteEP parámetro. El Connect método se bloqueará hasta que se conecte o produzca un error. Después de conectarse con el host remoto, use el GetStream método para obtener el subyacente NetworkStream. Úselo NetworkStream para enviar y recibir datos.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Después de obtener este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

Nota

Si recibe NotSupportedException con el mensaje This protocol version is not supported mientras usa la dirección IPv6, asegúrese de habilitar IPv6 en el constructor pasando InterNetworkV6.

Consulte también

Se aplica a

Connect(IPAddress, Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Conecta el cliente a un host TCP remoto con la dirección IP y el número de puerto 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

IPAddress del host con el que se desea conectar.

port
Int32

Número de puerto con el que se desea conectar.

Excepciones

El parámetro address es null.

port no se encuentra en el intervalo definido por MinPort y MaxPort.

Se produjo un error al acceder al socket.

Ejemplos

En el ejemplo de código siguiente se usa una dirección IP y un número de puerto para conectarse con un 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)

Comentarios

Llame a este método para establecer una conexión de host remoto sincrónica con el número de puerto y especificados IPAddress . El Connect método se bloqueará hasta que se conecte o produzca un error. Después de conectarse con el host remoto, use el GetStream método para obtener el subyacente NetworkStream. Úselo NetworkStream para enviar y recibir datos.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Después de obtener este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

Nota

Si recibe NotSupportedException con el mensaje This protocol version is not supported mientras usa la dirección IPv6, asegúrese de habilitar IPv6 en el constructor pasando InterNetworkV6.

Consulte también

Se aplica a

Connect(IPAddress[], Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Conecta el cliente a un host TCP remoto con las direcciones IP y el número de puerto que se especificaron.

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

Matriz IPAddress del host con el que desea conectar.

port
Int32

Número de puerto con el que se desea conectar.

Excepciones

El parámetro ipAddresses es null.

El número de puerto no es válido.

Error al intentar acceder al socket.

El Socket se ha cerrado.

Un llamador de la pila de llamadas no tiene permiso para la operación solicitada.

Este método es válido para sockets que utilizan el marcador InterNetwork o el marcador InterNetworkV6.

Ejemplos

En el ejemplo de código siguiente se usa una dirección IP y un número de puerto para conectarse con un 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");
}

Comentarios

Este método se usa normalmente inmediatamente después de una llamada al BeginGetHostAddresses método , que puede devolver varias direcciones IP para un único host. Llame al Connect método para establecer una conexión de host remoto sincrónica al host especificado por la matriz de elementos y el número de IPAddress puerto. El Connect método se bloqueará hasta que se conecte o produzca un error. Después de conectarse con el host remoto, use el GetStream método para obtener el subyacente NetworkStream. Úselo NetworkStream para enviar y recibir datos.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Después de obtener este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

Nota

Si recibe NotSupportedException con el mensaje This protocol version is not supported mientras usa la dirección IPv6, asegúrese de habilitar IPv6 en el constructor pasando InterNetworkV6.

Consulte también

Se aplica a

Connect(String, Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Conecta el cliente al puerto especificado en el 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

Nombre DNS del host remoto con el que se desea establecer conexión.

port
Int32

Número de puerto del host remoto con el que se desea establecer conexión.

Excepciones

El parámetro hostname es null.

El parámetro port no está entre MinPort y MaxPort.

Se produjo un error al acceder al socket.

Ejemplos

En el ejemplo de código siguiente se usa el nombre de host y el número de puerto para conectarse con un 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)

Comentarios

Llame a este método para establecer una conexión de host remota sincrónica con el nombre de host y el número de puerto especificados. El Connect método se bloqueará hasta que se conecte o produzca un error. Después de conectarse con el host remoto, use el GetStream método para obtener el subyacente NetworkStream. Úselo NetworkStream para enviar y recibir datos.

Si IPv6 está habilitado y Connect(String, Int32) se llama al método para conectarse a un host que se resuelve en direcciones IPv6 e IPv4, la conexión a la dirección IPv6 se intentará primero antes de la dirección IPv4. Esto puede tener el efecto de retrasar el tiempo para establecer la conexión si el host no escucha en la dirección IPv6.

Nota

Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Después de obtener este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

Consulte también

Se aplica a