TcpClient.Connect Método
Definición
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 -> unitPublic 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 -> unitPublic Sub Connect (address As IPAddress, port As Integer)Parámetros
- port
- Int32
Número de puerto con el que se desea conectar.
Excepciones
El parámetro address es null.
Se produjo un error al acceder al socket.
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
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 -> unitPublic Sub Connect (ipAddresses As IPAddress(), port As Integer)Parámetros
- 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 -> unitPublic 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.
Se produjo un error al acceder al socket.
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
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.
