TcpClient.Connect Método

Referencia

Definición

Espacio de nombres:: System.Net.Sockets

Ensamblado:: System.Net.Sockets.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

ArgumentNullException

El parámetro remoteEp es null.

SocketException

Se produjo un error al acceder al socket.

ObjectDisposedException

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

ArgumentNullException

El parámetro address es null.

ArgumentOutOfRangeException

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

SocketException

Se produjo un error al acceder al socket.

ObjectDisposedException

TcpClient está cerrado.

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

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

GetStream()

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

ArgumentNullException

El parámetro ipAddresses es null.

ArgumentOutOfRangeException

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

SocketException

Error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

SecurityException

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

NotSupportedException

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

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

TcpListener

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

ArgumentNullException

El parámetro hostname es null.

ArgumentOutOfRangeException

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

SocketException

Se produjo un error al acceder al socket.

ObjectDisposedException

TcpClient está cerrado.

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

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

TcpClient.Connect Método

Definición

Sobrecargas

Connect(IPEndPoint)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Connect(IPAddress, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Connect(IPAddress[], Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Connect(String, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Comentarios

Recursos adicionales