TcpClient Constructores
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í.
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.
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.