Socket.EndConnect メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Socket.EndConnect メソッド

保留中の非同期接続要求を終了します。

名前空間: System.Net.Sockets
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub EndConnect ( _
    asyncResult As IAsyncResult _
)

Visual Basic (使用法)

Dim instance As Socket
Dim asyncResult As IAsyncResult

instance.EndConnect(asyncResult)

public void EndConnect (
    IAsyncResult asyncResult
)

C++

public:
void EndConnect (
    IAsyncResult^ asyncResult
)

public void EndConnect (
    IAsyncResult asyncResult
)

JScript

public function EndConnect (
    asyncResult : IAsyncResult
)

パラメータ

asyncResult: この非同期操作の状態情報およびユーザー定義データを格納する IAsyncResult。

例外

例外の種類	条件
ArgumentNullException	asyncResult が null 参照 (Visual Basic では Nothing) です。
ArgumentException	BeginConnect メソッドへの呼び出しで asyncResult が返されませんでした。
InvalidOperationException	EndConnect は、非同期接続のために以前に呼び出されています。
SocketException	ソケットへのアクセスを試みているときにエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	Socket は閉じられています。

解説

EndConnect は、BeginConnect メソッドで開始されたリモートホスト接続の非同期要求を完了するブロッキングメソッドです。

BeginConnect を呼び出す前に、AsyncCallback デリゲートを実装するコールバックメソッドを作成する必要があります。このコールバックメソッドは個別のスレッドで実行され、BeginConnect の終了時に呼び出されます。コールバックメソッドは、BeginConnect メソッドからパラメータとして返された IAsyncResult を受け取る必要があります。

コールバックメソッド内では、IAsyncResult パラメータの AsyncState メソッドを呼び出して、接続が試行された Socket を取得します。Socket を取得したら、EndConnect メソッドを呼び出して接続の試行を正常に完了できます。

メモ
SocketException が発生した場合は、SocketException.ErrorCode プロパティを使用して具体的なエラーコードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラーコードのドキュメントでエラーの詳細情報を確認してください。これは MSDN ライブラリから入手できます。

メモ
このメンバは、アプリケーションでネットワークトレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

非同期接続の試行を終了するコード例を次に示します。ソケットを使用した非同期通信を示すコード例の全体については、「ソケットのコード例」を参照してください。

Visual Basic

Public Shared Sub Connect_Callback(ar
 As IAsyncResult)
   

   allDone.Set()
   Dim s As Socket = CType(ar.AsyncState, Socket)
   s.EndConnect(ar)
   Dim so2 As New StateObject()
   so2.workSocket = s
   Dim buff As Byte() =
 Encoding.ASCII.GetBytes("This is a test")
   s.BeginSend(buff, 0, buff.Length, 0, New AsyncCallback(AddressOf
 Async_Send_Receive.Send_Callback), so2)
End Sub 'Connect_Callback

allDone.Set();
Socket s = (Socket) ar.AsyncState;
s.EndConnect(ar);
StateObject so2 = new StateObject();
so2.workSocket = s;
byte[] buff = Encoding.ASCII.GetBytes("This is a test");
s.BeginSend(buff, 0, buff.Length,0,
                      new AsyncCallback(Async_Send_Receive.Send_Callback),
 so2);

C++

allDone->Set();
Socket^ s = safe_cast<Socket^>(ar->AsyncState);
s->EndConnect( ar );
StateObject^ so2 = gcnew StateObject;
so2->workSocket = s;
array<Byte>^ buff = Encoding::ASCII->GetBytes( "This is a test"
 );
s->BeginSend( buff, 0, buff->Length, SocketFlags::None,
   gcnew AsyncCallback( &Async_Send_Receive::Send_Callback ), so2 );

allDone.Set();
Socket s = (Socket)ar.get_AsyncState();
s.EndConnect(ar);
StateObject so2 = new StateObject();
so2.workSocket = s;
ubyte buff[] = Encoding.get_ASCII().GetBytes("This is a test");
s.BeginSend(buff, 0, buff.length, (SocketFlags)0,
    new AsyncCallback(Async_Send_Receive.Send_Callback), so2);