TcpClient.Connect Método

Definición

Espacio de nombres:: System.Net.Sockets

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

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 mediante el nombre de host y el número de puerto especificados.

Sobrecargas

Nombre	Description
Connect(IPEndPoint)	Conecta el cliente a un host TCP remoto mediante el punto de conexión de red remoto especificado.
Connect(IPAddress, Int32)	Conecta el cliente a un host TCP remoto mediante la dirección IP y el número de puerto especificados.
Connect(IPAddress[], Int32)	Conecta el cliente a un host TCP remoto mediante las direcciones IP y el número de puerto especificados.
Connect(String, Int32)	Conecta el cliente al puerto especificado en el host especificado.

Connect(IPEndPoint)

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Source:: TCPClient.cs

Conecta el cliente a un host TCP remoto mediante 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

al IPEndPoint que quiere conectarse.

Excepciones

ArgumentNullException

El remoteEP parámetro es null.

SocketException

Error al acceder al socket.

ObjectDisposedException

TcpClient Está cerrado.

Ejemplos

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

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 parámetro remoteEP . 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.

Note

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.

Note

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, vea Network Tracing in the .NET Framework.

Note

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

Source:: TCPClient.cs

Source:: TCPClient.cs

Conecta el cliente a un host TCP remoto mediante 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 al que quiere conectarse.

port: Int32

Número de puerto al que quiere conectarse.

Excepciones

ArgumentNullException

El address parámetro es null.

ArgumentOutOfRangeException

no port está entre MinPort y MaxPort.

SocketException

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

Note

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, vea Network Tracing in the .NET Framework.

Note

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

Source:: TCPClient.cs

Source:: TCPClient.cs

Conecta el cliente a un host TCP remoto mediante las direcciones IP y el número de puerto 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[]

Matriz IPAddress del host al que quiere conectarse.

port: Int32

Número de puerto al que quiere conectarse.

Excepciones

ArgumentNullException

El ipAddresses parámetro es null.

ArgumentOutOfRangeException

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

SocketException

Error al intentar acceder al socket.

ObjectDisposedException

Se Socket ha cerrado.

SecurityException

Un autor de llamada superior en la pila de llamadas no tiene permiso para la operación solicitada.

NotSupportedException

Este método es válido para sockets que usan la InterNetwork marca o la InterNetworkV6 marca .

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

Note

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, vea Network Tracing in the .NET Framework.

Note

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

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 al que quiere conectarse.

port: Int32

Número de puerto del host remoto al que quiere conectarse.

Excepciones

ArgumentNullException

El hostname parámetro es null.

ArgumentOutOfRangeException

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

SocketException

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

Note

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, vea Network Tracing in the .NET Framework.

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?