System.Net.Sockets.Socket.EndConnect Method

Ends a pending asynchronous connection request.

Syntax

public void EndConnect (IAsyncResult result)

Parameters

result
A IAsyncResult object that holds the state information for the asynchronous operation.

Exceptions

TypeReason
ArgumentNullException asyncResult is null.
ArgumentException asyncResult was not returned by the current instance from a call to the Socket.BeginConnect(System.Net.EndPoint, AsyncCallback, object) method.
InvalidOperationException Socket.EndConnect(IAsyncResult) was previously called for this operation.
System.Net.Sockets.SocketException
Note: For additional information on causes of the SocketException, see the System.Net.Sockets.SocketException class.
ObjectDisposedExceptionThe current instance has been disposed.

Remarks

Socket.EndConnect(IAsyncResult) is a blocking method that completes the asynchronous remote host connection request started in the Socket.BeginConnect(System.Net.EndPoint, AsyncCallback, object) method.

Before calling Socket.BeginConnect(System.Net.EndPoint, AsyncCallback, object), you need to create a callback method that implements the AsyncCallback delegate. This callback method executes in a separate thread and is called by the system after Socket.BeginConnect(System.Net.EndPoint, AsyncCallback, object) returns. The callback method must accept the IAsyncResult returned by the Socket.BeginConnect(System.Net.EndPoint, AsyncCallback, object) method as a parameter.

Within the callback method, call the IAsyncResult.AsyncState method of the IAsyncResult parameter to obtain the System.Net.Sockets.Socket on which the connection attempt is being made. After obtaining the System.Net.Sockets.Socket, you can call the Socket.EndConnect(IAsyncResult) method to successfully complete the connection attempt.

Note:

If you receive a System.Net.Sockets.SocketException, use the SocketException.ErrorCode property to obtain the specific error code. After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation in the MSDN library for a detailed description of the error.

Note:

This member outputs trace information when you enable network tracing in your application. For more information, see [<topic://conUsingNetworkTracing>].

Example

For an outline of an asynchronous operation, see the Socket.BeginAccept(AsyncCallback, object) method. For the complete example, which uses the Socket.EndConnect(IAsyncResult) method, see the System.Net.Sockets.Socket class overview.

Requirements

Namespace: System.Net.Sockets
Assembly: System (in System.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0