TcpClient Constructores

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.Sockets.dll

Inicializa una nueva instancia de la clase TcpClient.

Sobrecargas

TcpClient()	Inicializa una nueva instancia de la clase TcpClient.
TcpClient(IPEndPoint)	Inicializa una nueva instancia de la clase TcpClient y la enlaza con el punto de conexión local especificado.
TcpClient(AddressFamily)	Inicializa una nueva instancia de la clase TcpClient con la familia especificada.
TcpClient(String, Int32)	Inicializa una nueva instancia de la clase TcpClient y se conecta al puerto especificado en el host especificado.

TcpClient()

Source:

TCPClient.cs

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

Nota

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

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

• Connect(String, Int32)

TcpClient(IPEndPoint)

Source:

TCPClient.cs

Inicializa una nueva instancia de la clase TcpClient y la enlaza con el 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

IPEndPoint a la que asociará el TCP Socket.

Excepciones

ArgumentNullException

El parámetro localEP 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::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );
TcpClient^ tcpClientA = gcnew TcpClient( ipLocalEndPoint );

//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 IPEndPoint especificado por el localEP parámetro . Antes de llamar a este constructor, debe crear un IPEndPoint mediante la dirección IP y el número de puerto desde el que desea 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 mediante cualquier otro constructor, el proveedor de servicios subyacente asignará la dirección IP local y el número de puerto más adecuados.

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

Consulte también

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

Source:

TCPClient.cs

Inicializa una nueva instancia de la clase TcpClient 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

Propiedad AddressFamily del protocolo IP.

Excepciones

ArgumentException

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

O bien

El valor del parámetro family 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 = gcnew TcpClient( AddressFamily::InterNetwork );

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Comentarios

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.

TcpClient(String, Int32)

Source:

TCPClient.cs

Inicializa una nueva instancia de la clase TcpClient 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 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.

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 hostname and port.
TcpClient^ tcpClientB = gcnew TcpClient( "www.contoso.com",11000 );

//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 se 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.

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

• TcpClient
• Connect(String, Int32)