Socket.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(EndPoint, AsyncCallback, Object)	Inicia una solicitud asincrónica para una conexión a host remoto.
BeginConnect(IPAddress, Int32, AsyncCallback, Object)	Inicia una solicitud asincrónica para una conexión a host remoto. El host se especifica mediante una IPAddress y un número de puerto.
BeginConnect(IPAddress[], Int32, AsyncCallback, Object)	Inicia una solicitud asincrónica para una conexión a host remoto. El host se especifica mediante una matriz IPAddress y un número de puerto.
BeginConnect(String, Int32, AsyncCallback, Object)	Inicia una solicitud asincrónica para una conexión a host remoto. El host se especifica mediante un nombre de host y un número de puerto.

BeginConnect(EndPoint, AsyncCallback, Object)

Source:

Socket.cs

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

public:
 IAsyncResult ^ BeginConnect(System::Net::EndPoint ^ remoteEP, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginConnect (System.Net.EndPoint remoteEP, AsyncCallback? callback, object? state);

member this.BeginConnect : System.Net.EndPoint * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (remoteEP As EndPoint, callback As AsyncCallback, state As Object) As IAsyncResult

Parámetros

remoteEP

EndPoint

EndPoint que representa el host remoto.

callback

AsyncCallback

Delegado AsyncCallback.

state

Object

Objeto que contiene la información de estado para esta solicitud.

Devoluciones

IAsyncResult

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

Excepciones

ArgumentNullException

remoteEP es null.

SocketException

Solo .NET Framework y .NET 5 y versiones anteriores: se produjo un 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.

InvalidOperationException

Socket se ha colocado en un estado de escucha mediante una llamada a Listen(Int32) o ya hay una operación asincrónica en curso.

Comentarios

Importante

Se trata de una API de compatibilidad. No se recomienda usar los métodos de APM (Begin* y End*) para el nuevo desarrollo. En su lugar, use los Taskequivalentes basados en .

Los protocolos orientados a la conexión pueden usar el BeginAccept método para empezar a aceptar intentos de conexión entrantes. La operación de aceptación resultante se representa mediante el devuelto IAsyncResult aunque pueda completarse sincrónicamente. Antes de llamar al BeginAccept método , debe llamar al Listen método para escuchar y poner en cola las solicitudes de conexión entrantes.

Puede pasar una devolución de llamada que se implemente AsyncCallbackBeginAccept en para recibir una notificación sobre la finalización de la operación de aceptación. Tenga en cuenta que si la pila de red subyacente completa la operación de forma sincrónica, es posible que la devolución de llamada se ejecute en línea durante la llamada a BeginAccept. En este caso, la CompletedSynchronously propiedad del devuelto IAsyncResult se establecerá en true para indicar que el método se completó de forma sincrónica. Utilice la AsyncState propiedad de para obtener el objeto de IAsyncResult estado pasado al BeginAccept método .

La BeginAccept operación debe completarse llamando al EndAccept método . Normalmente, el delegado proporcionado AsyncCallback invoca el método . EndAccept bloqueará el subproceso que realiza la llamada hasta que se complete la operación.

Para cancelar una llamada pendiente al BeginAccept método , cierre .Socket Cuando se llama al Close método mientras una operación asincrónica está en curso, se llama a la devolución de llamada proporcionada al BeginAccept método . Una llamada posterior al EndAccept método iniciará ( ObjectDisposedException antes de .NET 7) o un SocketException (en .NET 7+) para indicar que se ha cancelado la operación.

Nota

Puede usar la RemoteEndPoint propiedad del devuelto Socket para identificar la dirección de red y el número de puerto del host remoto.

Nota

Si recibe un SocketException, use la SocketException.ErrorCode propiedad para obtener el código de error específico.

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, consulte Seguimiento de red en .NET Framework.

Nota

El contexto de ejecución (el contexto de seguridad, el usuario suplantado y el contexto de llamada) se almacena en caché para los métodos asincrónicos Socket . Después del primer uso de un contexto determinado (un método asincrónico Socket específico, una instancia específica Socket y una devolución de llamada específica), los usos posteriores de ese contexto verán una mejora del rendimiento.

Consulte también

• AsyncCallback
• EndConnect(IAsyncResult)
• BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Calcular las referencias de un delegado como un método de devolución de llamada
• Ejemplo de sockets de cliente asincrónicos
• Ejemplo de sockets de servidor asincrónicos

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Source:

Socket.cs

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

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 de conexió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

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

Excepciones

ArgumentNullException

address es null.

SocketException

Solo .NET Framework y .NET 5 y versiones anteriores: se produjo un error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

NotSupportedException

El Socket no está en la familia de sockets.

ArgumentOutOfRangeException

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

ArgumentException

La longitud de address es cero.

InvalidOperationException

Socket se ha colocado en un estado de escucha mediante una llamada a Listen(Int32) o ya hay una operación asincrónica en curso.

Comentarios

Importante

Se trata de una API de compatibilidad. No se recomienda usar los métodos de APM (Begin* y End*) para el nuevo desarrollo. En su lugar, use los Taskequivalentes basados en .

Si usa un protocolo orientado a la conexión, el BeginConnect método inicia una solicitud asincrónica para una conexión al endpoit especificado por el remoteEP parámetro . Si usa un protocolo sin conexión, BeginConnect establece un host remoto predeterminado.

Puede pasar una devolución de llamada que se implemente AsyncCallbackBeginConnect en para recibir una notificación sobre la finalización de la operación de conexión. Tenga en cuenta que si la pila de red subyacente completa la operación de forma sincrónica, es posible que la devolución de llamada se ejecute en línea durante la llamada a BeginConnect. En este caso, la CompletedSynchronously propiedad del devuelto IAsyncResult se establecerá en true para indicar que el método se completó de forma sincrónica. Utilice la AsyncState propiedad de para obtener el objeto de IAsyncResult estado pasado al BeginConnect método .

La BeginConnect operación debe completarse llamando al EndConnect método . Normalmente, el delegado proporcionado AsyncCallback invoca el método . EndConnect bloqueará el subproceso que realiza la llamada hasta que se complete la operación.

Si usa un protocolo sin conexión como UDP, no tiene que llamar BeginConnect a antes de enviar y recibir datos. Puede usar BeginSendTo y BeginReceiveFrom comunicarse con un host remoto. Si llama a BeginConnect, se descartarán los datagramas que lleguen desde una dirección distinta del valor predeterminado especificado. Si desea establecer el host remoto predeterminado en una dirección de difusión, primero debe llamar SetSocketOption a y establecer Broadcast en true. Si no puede, BeginConnect iniciará una SocketExceptionexcepción .

Si usa un protocolo orientado a la conexión y no llama a antes de llamar Bind a BeginConnect, el proveedor de servicios subyacente asignará la dirección de red local y el número de puerto más apropiados. Si usa un protocolo sin conexión, el proveedor de servicios no asignará una dirección de red local y un número de puerto hasta que llame al BeginSend método o ReceiveFrom . Si desea cambiar el host remoto predeterminado, llame al BeginConnect método de nuevo con el punto de conexión deseado.

Para cancelar una llamada pendiente al BeginConnect método , cierre .Socket Cuando se llama al Close método mientras una operación asincrónica está en curso, se llama a la devolución de llamada proporcionada al BeginConnect método . Una llamada posterior al EndConnect método iniciará ( ObjectDisposedException antes de .NET 7) o un SocketException (en .NET 7+) para indicar que se ha cancelado la operación.

Nota

Si recibe un SocketException, use la SocketException.ErrorCode propiedad para obtener el código de error específico.

Nota

Si este socket se ha desconectado anteriormente, BeginConnect se debe llamar a en un subproceso que no se cerrará hasta que se complete la operación. Se trata de una limitación del proveedor subyacente.

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

El contexto de ejecución (el contexto de seguridad, el usuario suplantado y el contexto de llamada) se almacena en caché para los métodos asincrónicos Socket . Después del primer uso de un contexto determinado (un método asincrónico Socket específico, una instancia específica Socket y una devolución de llamada específica), los usos posteriores de ese contexto verán una mejora del rendimiento.

Consulte también

• AsyncCallback
• EndConnect(IAsyncResult)
• BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Calcular las referencias de un delegado como un método de devolución de llamada
• Ejemplo de sockets de cliente asincrónicos
• Ejemplo de sockets de servidor asincrónicos

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

Source:

Socket.cs

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

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[]

Al menos una IPAddress, que designa el 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 de conexió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

IAsyncResult que hace referencia a las conexiones asincrónicas.

Excepciones

ArgumentNullException

addresses es null.

SocketException

Solo .NET Framework y .NET 5 y versiones anteriores: se produjo un error al intentar acceder al socket.

ObjectDisposedException

El Socket se ha cerrado.

NotSupportedException

Este método es válido para sockets que usan InterNetwork o InterNetworkV6.

ArgumentOutOfRangeException

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

ArgumentException

La longitud de address es cero.

InvalidOperationException

Socket se ha colocado en un estado de escucha mediante una llamada a Listen(Int32) o ya hay una operación asincrónica en curso.

Comentarios

Importante

Se trata de una API de compatibilidad. No se recomienda usar los métodos de APM (Begin* y End*) para el nuevo desarrollo. En su lugar, use los Taskequivalentes basados en .

Si usa un protocolo orientado a la conexión, el BeginConnect método inicia una solicitud asincrónica para una conexión al endpoit especificado por el remoteEP parámetro . Si usa un protocolo sin conexión, BeginConnect establece un host remoto predeterminado.

Puede pasar una devolución de llamada que se AsyncCallback implemente en BeginConnect para recibir una notificación sobre la finalización de la operación de conexión. Tenga en cuenta que si la pila de red subyacente completa la operación de forma sincrónica, es posible que la devolución de llamada se ejecute en línea durante la llamada a BeginConnect. En este caso, la CompletedSynchronously propiedad del devuelto IAsyncResult se establecerá true en para indicar que el método se completó sincrónicamente. Utilice la AsyncState propiedad de IAsyncResult para obtener el objeto de estado pasado al BeginConnect método .

La BeginConnect operación debe completarse llamando al EndConnect método . Normalmente, el delegado proporcionado AsyncCallback invoca el método . EndConnect bloqueará el subproceso que realiza la llamada hasta que se complete la operación.

Si usa un protocolo sin conexión como UDP, no tiene que llamar BeginConnect a antes de enviar y recibir datos. Puede usar BeginSendTo y BeginReceiveFrom para comunicarse con un host remoto. Si llama a BeginConnect, se descartarán los datagramas que lleguen desde una dirección distinta del valor predeterminado especificado. Si desea establecer el host remoto predeterminado en una dirección de difusión, primero debe llamar SetSocketOption a y establecer Broadcast en true. Si no puede, BeginConnect producirá una SocketExceptionexcepción .

Si usa un protocolo orientado a la conexión y no llama Bind a antes de llamar a BeginConnect, el proveedor de servicios subyacente asignará la dirección de red local y el número de puerto más adecuados. Si usa un protocolo sin conexión, el proveedor de servicios no asignará una dirección de red local y un número de puerto hasta que llame al BeginSend método o ReceiveFrom . Si desea cambiar el host remoto predeterminado, vuelva a llamar al BeginConnect método con el punto de conexión deseado.

Para cancelar una llamada pendiente al BeginConnect método , cierre .Socket Cuando se llama al Close método mientras una operación asincrónica está en curso, se llama a la devolución de llamada proporcionada al BeginConnect método . Una llamada posterior al EndConnect método iniciará ( ObjectDisposedException antes de .NET 7) o ( SocketException en .NET 7 y versiones posteriores) para indicar que se ha cancelado la operación.

Nota

Si recibe un SocketException, use la SocketException.ErrorCode propiedad para obtener el código de error específico.

Nota

Si este socket se ha desconectado anteriormente, BeginConnect se debe llamar a en un subproceso que no se cerrará hasta que se complete la operación. Se trata de una limitación del proveedor subyacente.

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

El contexto de ejecución (el contexto de seguridad, el usuario suplantado y el contexto de llamada) se almacena en caché para los métodos asincrónicos Socket . Después del primer uso de un contexto determinado (un método asincrónico Socket específico, una instancia específica Socket y una devolución de llamada específica), los usos posteriores de ese contexto verán una mejora del rendimiento.

Consulte también

• AsyncCallback
• EndConnect(IAsyncResult)
• BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Calcular las referencias de un delegado como un método de devolución de llamada
• Ejemplo de sockets de cliente asincrónicos
• Ejemplo de sockets de servidor asincrónicos

BeginConnect(String, Int32, AsyncCallback, Object)

Source:

Socket.cs

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

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 de conexió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

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

Excepciones

ArgumentNullException

host es null.

ObjectDisposedException

Se cerró el Socket.

NotSupportedException

Este método es válido para sockets de las familias InterNetwork o InterNetworkV6.

ArgumentOutOfRangeException

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

InvalidOperationException

Socket se ha colocado en un estado de escucha mediante una llamada a Listen(Int32) o ya hay una operación asincrónica en curso.

Comentarios

Importante

Se trata de una API de compatibilidad. No se recomienda usar los métodos de APM (Begin* y End*) para el nuevo desarrollo. En su lugar, use los Taskequivalentes basados en .

Si usa un protocolo orientado a la conexión, el BeginConnect método inicia una solicitud asincrónica para una conexión al endpoit especificado por el remoteEP parámetro . Si usa un protocolo sin conexión, BeginConnect establece un host remoto predeterminado.

Puede pasar una devolución de llamada que se AsyncCallback implemente en BeginConnect para recibir una notificación sobre la finalización de la operación de conexión. Tenga en cuenta que si la pila de red subyacente completa la operación de forma sincrónica, es posible que la devolución de llamada se ejecute en línea durante la llamada a BeginConnect. En este caso, la CompletedSynchronously propiedad del devuelto IAsyncResult se establecerá true en para indicar que el método se completó sincrónicamente. Utilice la AsyncState propiedad de IAsyncResult para obtener el objeto de estado pasado al BeginConnect método .

La BeginConnect operación debe completarse llamando al EndConnect método . Normalmente, el delegado proporcionado AsyncCallback invoca el método . EndConnect bloqueará el subproceso que realiza la llamada hasta que se complete la operación.

Si usa un protocolo sin conexión como UDP, no tiene que llamar BeginConnect a antes de enviar y recibir datos. Puede usar BeginSendTo y BeginReceiveFrom para comunicarse con un host remoto. Si llama a BeginConnect, se descartarán los datagramas que lleguen desde una dirección distinta del valor predeterminado especificado. Si desea establecer el host remoto predeterminado en una dirección de difusión, primero debe llamar SetSocketOption a y establecer Broadcast en true. Si no puede, BeginConnect producirá una SocketExceptionexcepción .

Si usa un protocolo orientado a la conexión y no llama Bind a antes de llamar a BeginConnect, el proveedor de servicios subyacente asignará la dirección de red local y el número de puerto más adecuados. Si usa un protocolo sin conexión, el proveedor de servicios no asignará una dirección de red local y un número de puerto hasta que llame al BeginSend método o ReceiveFrom . Si desea cambiar el host remoto predeterminado, vuelva a llamar al BeginConnect método con el punto de conexión deseado.

Para cancelar una llamada pendiente al BeginConnect método , cierre .Socket Cuando se llama al Close método mientras una operación asincrónica está en curso, se llama a la devolución de llamada proporcionada al BeginConnect método . Una llamada posterior al EndConnect método iniciará ( ObjectDisposedException antes de .NET 7) o ( SocketException en .NET 7 y versiones posteriores) para indicar que se ha cancelado la operación.

Nota

Si recibe un SocketException, use la SocketException.ErrorCode propiedad para obtener el código de error específico.

Nota

Si este socket se ha desconectado anteriormente, BeginConnect se debe llamar a en un subproceso que no se cerrará hasta que se complete la operación. Se trata de una limitación del proveedor subyacente.

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, consulte Seguimiento de red en .NET Framework.

Nota

El contexto de ejecución (el contexto de seguridad, el usuario suplantado y el contexto de llamada) se almacena en caché para los métodos asincrónicos Socket . Después del primer uso de un contexto determinado (un método asincrónico Socket específico, una instancia específica Socket y una devolución de llamada específica), los usos posteriores de ese contexto verán una mejora del rendimiento.

Consulte también

• AsyncCallback
• EndConnect(IAsyncResult)
• BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Calcular las referencias de un delegado como un método de devolución de llamada
• Ejemplo de sockets de cliente asincrónicos
• Ejemplo de sockets de servidor asincrónicos