TcpClient Constructores

Definición

Inicializa una nueva instancia de la clase TcpClient.

Sobrecargas

Nombre Description
TcpClient()

Inicializa una nueva instancia de la clase TcpClient.

TcpClient(IPEndPoint)

Inicializa una nueva instancia de la TcpClient clase y la enlaza al punto de conexión local especificado.

TcpClient(AddressFamily)

Inicializa una nueva instancia de la TcpClient clase con la familia especificada.

TcpClient(String, Int32)

Inicializa una nueva instancia de la TcpClient clase y se conecta al puerto especificado en el host especificado.

TcpClient()

Inicializa una nueva instancia de la clase TcpClient.

public:
 TcpClient();
public TcpClient();
Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el constructor sin parámetros para crear un nuevo TcpClient.

//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient ();
'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient

Comentarios

Este constructor crea un nuevo TcpClient y permite al proveedor de servicios subyacente asignar la dirección IP local y el número de puerto más apropiados. Primero debe llamar al Connect método antes de enviar y recibir datos.

Note

En .NET Framework, este constructor solo funciona con tipos de direcciones IPv4.

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

TcpClient(IPEndPoint)

Inicializa una nueva instancia de la TcpClient clase y la enlaza al punto de conexión local especificado.

public:
 TcpClient(System::Net::IPEndPoint ^ localEP);
public TcpClient(System.Net.IPEndPoint localEP);
new System.Net.Sockets.TcpClient : System.Net.IPEndPoint -> System.Net.Sockets.TcpClient
Public Sub New (localEP As IPEndPoint)

Parámetros

localEP
IPEndPoint

al IPEndPoint que se enlaza el TCP Socket.

Excepciones

El localEP parámetro es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una instancia de la TcpClient clase mediante un punto de conexión local.

//Creates a TCPClient using a local end point.
IPAddress ipAddress = Dns.GetHostEntry (Dns.GetHostName ()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 0);
TcpClient tcpClientA = new TcpClient (ipLocalEndPoint);
'Creates a TCPClient using a local endpoint.
Dim ipAddress As IPAddress = Dns.GetHostEntry(Dns.GetHostName()).AddressList(0)
   Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 0)

   Dim tcpClientA As New TcpClient(ipLocalEndPoint)

Comentarios

Este constructor crea un nuevo TcpClient y lo enlaza al especificado IPEndPoint por el localEP parámetro . Antes de llamar a este constructor, debe crear un IPEndPoint con la dirección IP y el número de puerto desde el que quiere enviar y recibir datos. No es necesario especificar una dirección IP local y un número de puerto antes de conectarse y comunicarse. Si crea un TcpClient con cualquier otro constructor, el proveedor de servicios subyacente asignará la dirección IP local y el número de puerto más apropiados.

Debe llamar al Connect método antes de 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.

Consulte también

Se aplica a

TcpClient(AddressFamily)

Inicializa una nueva instancia de la TcpClient clase con la familia especificada.

public:
 TcpClient(System::Net::Sockets::AddressFamily family);
public TcpClient(System.Net.Sockets.AddressFamily family);
new System.Net.Sockets.TcpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.TcpClient
Public Sub New (family As AddressFamily)

Parámetros

family
AddressFamily

AddressFamily del protocolo IP.

Excepciones

El family parámetro no es igual a AddressFamily.InterNetwork

O bien

El family parámetro no es igual a AddressFamily.InterNetworkV6

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una instancia de la TcpClient clase .

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);
Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Comentarios

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.

Se aplica a

TcpClient(String, Int32)

Inicializa una nueva instancia de la TcpClient clase y se conecta al puerto especificado en el host especificado.

public:
 TcpClient(System::String ^ hostname, int port);
public TcpClient(string hostname, int port);
new System.Net.Sockets.TcpClient : string * int -> System.Net.Sockets.TcpClient
Public Sub New (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

El hostname parámetro es null.

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

Error al acceder al socket.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una instancia de la TcpClient clase mediante un nombre de host y un número de puerto.

//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient ("www.contoso.com", 11000);
'Creates a TCPClient using hostname and port.

Dim tcpClientB As New TcpClient("www.contoso.com", 11000)

Comentarios

Este constructor crea un nuevo TcpClient y realiza un intento de conexión sincrónica al nombre de host y al número de puerto proporcionados. El proveedor de servicios subyacente asignará la dirección IP local y el número de puerto más adecuados. TcpClient se bloqueará hasta que se conecte o produzca un error. Este constructor le permite inicializar, resolver el nombre de host DNS y conectarse en un paso conveniente.

Si IPv6 está habilitado y TcpClient(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

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.

Consulte también

Se aplica a