TcpClient.BeginConnect Método

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.Sockets.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

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);

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.

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

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);

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.

BeginConnect(String, Int32, AsyncCallback, Object)

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);

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.