TcpClient.ConnectAsync Método

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.Sockets.dll

Conecta el cliente a un host TCP remoto con el nombre de host y el número de puerto especificados como una operación asincrónica.

Sobrecargas

ConnectAsync(String, Int32, CancellationToken)	Conecta al cliente con el puerto TCP especificado en el host especificado como una operación asincrónica.
ConnectAsync(IPAddress[], Int32, CancellationToken)	Conecta el cliente a un host TCP remoto con las direcciones IP y el número de puerto especificados como una operación asincrónica.
ConnectAsync(IPAddress, Int32, CancellationToken)	Conecta el cliente a un host TCP remoto con la dirección IP y el número de puerto especificados como una operación asincrónica.
ConnectAsync(String, Int32)	Conecta al cliente con el puerto TCP especificado en el host especificado como una operación asincrónica.
ConnectAsync(IPEndPoint, CancellationToken)	Conecta el cliente a un host TCP remoto mediante el punto de conexión especificado como una operación asincrónica.
ConnectAsync(IPAddress[], Int32)	Conecta el cliente a un host TCP remoto con las direcciones IP y el número de puerto especificados como una operación asincrónica.
ConnectAsync(IPAddress, Int32)	Conecta el cliente a un host TCP remoto con la dirección IP y el número de puerto especificados como una operación asincrónica.
ConnectAsync(IPEndPoint)	Conecta el cliente a un host TCP remoto mediante el punto de conexión especificado como una operación asincrónica.

ConnectAsync(String, Int32, CancellationToken)

Source:

TCPClient.cs

Conecta al cliente con el puerto TCP especificado en el host especificado como una operación asincrónica.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (string host, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parámetros

host

String

Nombre DNS del host remoto.

port

Int32

Número de puerto del host remoto.

cancellationToken

CancellationToken

Token de cancelación que se puede usar para señalar que la operación asincrónica se debe cancelar.

Devoluciones

ValueTask

Tarea que representa la operación de conexión asincrónica.

Excepciones

ArgumentNullException

El parámetro host es null.

ArgumentOutOfRangeException

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

SocketException

Se produjo un error al acceder al socket.

ObjectDisposedException

TcpClient está cerrado.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. La tarea devuelta se completará una vez establecida la conexión TCP. Este método no bloquea el subproceso de llamada mientras la solicitud de conexión está en curso.

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 como una operación asincrónica. 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 ConnectAsync(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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Connect(String, Int32).

Consulte también

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPAddress[], Int32, CancellationToken)

Source:

TCPClient.cs

Conecta el cliente a un host TCP remoto con las direcciones IP y el número de puerto especificados como una operación asincrónica.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

Parámetros

addresses

IPAddress[]

Matriz de direcciones IP del host remoto.

port

Int32

Número de puerto del host remoto.

cancellationToken

CancellationToken

Token de cancelación que se puede usar para señalar que la operación asincrónica se debe cancelar.

Devoluciones

ValueTask

Tarea que representa la operación de conexión asincrónica.

Excepciones

ArgumentNullException

El parámetro ipAddresses es null.

ArgumentOutOfRangeException

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

SocketException

Error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

SecurityException

Un llamador de la pila de llamadas no tiene permiso para la operación solicitada.

NotSupportedException

Este método es válido para sockets que utilizan el marcador InterNetwork o el marcador InterNetworkV6.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. La tarea devuelta se completará una vez establecida la conexión TCP. Este método no bloquea el subproceso de llamada mientras la solicitud de conexión está en curso.

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 a este método para establecer una conexión de host remoto sincrónica con el host especificado por la matriz de direcciones IP y el número de puerto como una operación asincrónica. 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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Connect(IPAddress[], Int32).

Consulte también

• TcpListener

ConnectAsync(IPAddress, Int32, CancellationToken)

Source:

TCPClient.cs

Conecta el cliente a un host TCP remoto con la dirección IP y el número de puerto especificados como una operación asincrónica.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parámetros

address

IPAddress

Dirección IP del host remoto.

port

Int32

Número de puerto del host remoto.

cancellationToken

CancellationToken

Token de cancelación que se puede usar para señalar que la operación asincrónica se debe cancelar.

Devoluciones

ValueTask

Tarea que representa la operación de conexión asincrónica.

Excepciones

ArgumentNullException

El parámetro address es null.

ArgumentOutOfRangeException

port no se encuentra en el intervalo definido por MinPort y MaxPort.

SocketException

Se produjo un error al acceder al socket.

ObjectDisposedException

TcpClient está cerrado.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. La tarea devuelta se completará una vez establecida la conexión TCP. Este método no bloquea el subproceso de llamada mientras la solicitud de conexión está en curso.

Llame a este método para establecer una conexión de host remoto sincrónica con la dirección IP y el número de puerto especificados como una operación asincrónica. 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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Connect(IPAddress, Int32).

Consulte también

• GetStream()

ConnectAsync(String, Int32)

Source:

TCPClient.cs

Conecta al cliente con el puerto TCP especificado en el host especificado como una operación asincrónica.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);

public System.Threading.Tasks.Task ConnectAsync (string host, int port);

member this.ConnectAsync : string * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (host As String, port As Integer) As Task

Parámetros

host

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.

Devoluciones

Task

Objeto de tarea que representa la operación asincrónica.

Excepciones

ArgumentNullException

El parámetro host es null.

ArgumentOutOfRangeException

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

SocketException

Se produjo un error al acceder al socket.

ObjectDisposedException

TcpClient está cerrado.

Comentarios

Esta operación no se bloqueará. El objeto Returns Task devuelto se completará una vez establecida la conexión TCP. Este método no bloquea el subproceso que realiza la llamada mientras la solicitud de conexión está en curso.

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 como una operación asincrónica. 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 ConnectAsync(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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Connect(String, Int32).

Consulte también

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPEndPoint, CancellationToken)

Source:

TCPClient.cs

Conecta el cliente a un host TCP remoto mediante el punto de conexión especificado como una operación asincrónica.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPEndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPEndPoint remoteEP, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTask

Parámetros

remoteEP

IPEndPoint

IPEndPoint con el que desea conectar.

cancellationToken

CancellationToken

Token de cancelación que se usa para propagar la notificación de que se debería cancelar esta operación.

Devoluciones

ValueTask

Tarea que representa la operación asincrónica.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Esta operación no se bloqueará. El objeto Returns Task devuelto se completará una vez establecida la conexión TCP. Este método no bloquea el subproceso que realiza la llamada mientras la solicitud de conexión está en curso.

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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Connect(IPEndPoint).

ConnectAsync(IPAddress[], Int32)

Source:

TCPClient.cs

Conecta el cliente a un host TCP remoto con las direcciones IP y el número de puerto especificados como una operación asincrónica.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);

public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress[] addresses, int port);

member this.ConnectAsync : System.Net.IPAddress[] * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task

Parámetros

addresses

IPAddress[]

Matriz IPAddress del host con el que desea conectar.

port

Int32

Número de puerto con el que se desea conectar.

Devoluciones

Task

Objeto de tarea que representa la operación asincrónica.

Excepciones

ArgumentNullException

El parámetro ipAddresses es null.

ArgumentOutOfRangeException

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

SocketException

Error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

SecurityException

Un llamador de la pila de llamadas no tiene permiso para la operación solicitada.

NotSupportedException

Este método es válido para sockets que utilizan el marcador InterNetwork o el marcador InterNetworkV6.

Comentarios

Esta operación no se bloqueará. El objeto Returns Task devuelto se completará una vez establecida la conexión TCP. Este método no bloquea el subproceso que realiza la llamada mientras la solicitud de conexión está en curso.

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 a este 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 como una operación asincrónica. 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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Connect(IPAddress[], Int32).

Consulte también

• TcpListener

ConnectAsync(IPAddress, Int32)

Source:

TCPClient.cs

Conecta el cliente a un host TCP remoto con la dirección IP y el número de puerto especificados como una operación asincrónica.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);

public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress address, int port);

member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (address As IPAddress, port As Integer) As Task

Parámetros

address

IPAddress

IPAddress del host con el que se desea conectar.

port

Int32

Número de puerto con el que se desea conectar.

Devoluciones

Task

Objeto de tarea que representa la operación asincrónica.

Excepciones

ArgumentNullException

El parámetro address es null.

ArgumentOutOfRangeException

port no se encuentra en el intervalo definido por MinPort y MaxPort.

SocketException

Se produjo un error al acceder al socket.

ObjectDisposedException

TcpClient está cerrado.

Comentarios

Esta operación no se bloqueará. El objeto Returns Task devuelto se completará una vez establecida la conexión TCP. Este método no bloquea el subproceso que realiza la llamada mientras la solicitud de conexión está en curso.

Llame a este método para establecer una conexión de host remoto sincrónica con el número de puerto y especificado IPAddress como una operación asincrónica. 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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Connect(IPAddress, Int32).

Consulte también

• GetStream()

ConnectAsync(IPEndPoint)

Source:

TCPClient.cs

Conecta el cliente a un host TCP remoto mediante el punto de conexión especificado como una operación asincrónica.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPEndPoint ^ remoteEP);

public System.Threading.Tasks.Task ConnectAsync (System.Net.IPEndPoint remoteEP);

member this.ConnectAsync : System.Net.IPEndPoint -> System.Threading.Tasks.Task

Public Function ConnectAsync (remoteEP As IPEndPoint) As Task

Parámetros

remoteEP

IPEndPoint

IPEndPoint con el que desea conectar.

Devoluciones

Task

Tarea que representa la operación asincrónica.

Comentarios

Esta operación no se bloqueará. El objeto devuelto Task se completará una vez establecida la conexión TCP. Este método no bloquea el subproceso que realiza la llamada mientras la solicitud de conexión está en curso.

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 un NotSupportedException con el mensaje "Esta versión del protocolo no se admite" mientras usa la dirección IPv6, asegúrese de habilitar IPv6 en el constructor pasando InterNetworkV6.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Connect(IPEndPoint).