Compartir a través de

TcpClient.BeginConnect Método

  • Referencia

Definición

Espacio de nombres:
System.Net.Sockets
Ensamblado:
System.Net.Sockets.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll

Inicia una solicitud asincrónica para una conexión a host remoto.

Sobrecargas

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Inicia una solicitud asincrónica para una conexión a host remoto. El host remoto se especifica mediante un IPAddress y un número de puerto (Int32).
BeginConnect(IPAddress[], Int32, AsyncCallback, Object)

Inicia una solicitud asincrónica para una conexión a host remoto. El host remoto se especifica mediante una matriz IPAddress y un número de puerto (Int32).
BeginConnect(String, Int32, AsyncCallback, Object)

Inicia una solicitud asincrónica para una conexión a host remoto. El host remoto se especifica mediante un nombre de host (String) y un número de puerto (Int32).

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Inicia una solicitud asincrónica para una conexión a host remoto. El host remoto se especifica mediante un IPAddress y un número de puerto (Int32).

public:
 IAsyncResult ^ BeginConnect(System::Net::IPAddress ^ address, int port, AsyncCallback ^ requestCallback, System::Object ^ state);
public IAsyncResult BeginConnect (System.Net.IPAddress address, int port, AsyncCallback? requestCallback, object? state);
public IAsyncResult BeginConnect (System.Net.IPAddress address, int port, AsyncCallback requestCallback, object state);
member this.BeginConnect : System.Net.IPAddress * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parámetros

address
IPAddress

IPAddress del host remoto.

port
Int32

Número de puerto del host remoto.

requestCallback
AsyncCallback

Delegado de AsyncCallback que hace referencia al método que se invocará cuando la operación se complete.

state
Object

Objeto definido por el usuario que contiene información sobre la operación de conexión. Este objeto se pasa al delegado de requestCallback cuando la operación se completa.

Devoluciones

IAsyncResult

Objeto IAsyncResult que hace referencia a la conexión asincrónica.

Excepciones

ArgumentNullException

El parámetro address es null.

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.

ArgumentOutOfRangeException

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

Comentarios

La operación asincrónica BeginConnect debe completarse llamando al EndConnect método . Normalmente, el delegado invoca el asyncCallback método .

Este método no se bloquea hasta que se completa la operación. Para bloquear hasta que se complete la operación, use una de las sobrecargas del Connect método .

Para obtener información detallada sobre el uso del modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.

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.

Se aplica a

BeginConnect(IPAddress[], Int32, AsyncCallback, Object)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Inicia una solicitud asincrónica para una conexión a host remoto. El host remoto se especifica mediante una matriz IPAddress y un número de puerto (Int32).

public:
 IAsyncResult ^ BeginConnect(cli::array <System::Net::IPAddress ^> ^ addresses, int port, AsyncCallback ^ requestCallback, System::Object ^ state);
public IAsyncResult BeginConnect (System.Net.IPAddress[] addresses, int port, AsyncCallback? requestCallback, object? state);
public IAsyncResult BeginConnect (System.Net.IPAddress[] addresses, int port, AsyncCallback requestCallback, object state);
member this.BeginConnect : System.Net.IPAddress[] * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parámetros

addresses
IPAddress[]

Como mínimo un IPAddress que designa los host remotos.

port
Int32

Número de puerto de los host remotos.

requestCallback
AsyncCallback

Delegado de AsyncCallback que hace referencia al método que se invocará cuando la operación se complete.

state
Object

Objeto definido por el usuario que contiene información sobre la operación de conexión. Este objeto se pasa al delegado de requestCallback cuando la operación se completa.

Devoluciones

IAsyncResult

Objeto IAsyncResult que hace referencia a la conexión asincrónica.

Excepciones

ArgumentNullException

El parámetro addresses es null.

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.

ArgumentOutOfRangeException

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

Comentarios

La operación asincrónica BeginConnect debe completarse llamando al EndConnect método . Normalmente, el delegado invoca el asyncCallback método .

Este método no se bloquea hasta que se completa la operación. Para bloquear hasta que se complete la operación, use una de las sobrecargas del Connect método .

Para obtener información detallada sobre el uso del modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.

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.

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.

Se aplica a

BeginConnect(String, Int32, AsyncCallback, Object)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

Inicia una solicitud asincrónica para una conexión a host remoto. El host remoto se especifica mediante un nombre de host (String) y un número de puerto (Int32).

public:
 IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);
public IAsyncResult BeginConnect (string host, int port, AsyncCallback? requestCallback, object? state);
public IAsyncResult BeginConnect (string host, int port, AsyncCallback requestCallback, object state);
member this.BeginConnect : string * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parámetros

host
String

Nombre del host remoto.

port
Int32

Número de puerto del host remoto.

requestCallback
AsyncCallback

Delegado de AsyncCallback que hace referencia al método que se invocará cuando la operación se complete.

state
Object

Objeto definido por el usuario que contiene información sobre la operación de conexión. Este objeto se pasa al delegado de requestCallback cuando la operación se completa.

Devoluciones

IAsyncResult

Objeto IAsyncResult que hace referencia a la conexión asincrónica.

Excepciones

ArgumentNullException

El parámetro host es null.

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.

ArgumentOutOfRangeException

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

Comentarios

La operación asincrónica BeginConnect debe completarse llamando al EndConnect método . Normalmente, el delegado invoca el asyncCallback método .

Este método no se bloquea hasta que se completa la operación. Para bloquear hasta que se complete la operación, use una de las sobrecargas del Connect método .

Para obtener información detallada sobre el uso del modelo de programación asincrónica, vea Llamar a métodos sincrónicos de forma asincrónica.

Se aplica a