TcpClient.EndConnect メソッド

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

TcpClient.EndConnect メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

受信接続の試行を非同期的に受け入れます。

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

Visual Basic (宣言)

Public Sub EndConnect ( _
    asyncResult As IAsyncResult _
)

Visual Basic (使用法)

Dim instance As TcpClient
Dim asyncResult As IAsyncResult

instance.EndConnect(asyncResult)

C#

public void EndConnect (
    IAsyncResult asyncResult
)

C++

public:
void EndConnect (
    IAsyncResult^ asyncResult
)

J#

public void EndConnect (
    IAsyncResult asyncResult
)

JScript

public function EndConnect (
    asyncResult : IAsyncResult
)

パラメータ

asyncResult

BeginConnect の呼び出しによって返される IAsyncResult オブジェクト。

例外

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

解説

このメソッドは、操作が完了するまでブロックします。この操作を同期的に実行するには、Connect メソッドを使用します。

メモ
SocketException が発生した場合は、SocketException.ErrorCode を使用して具体的なエラー コードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラー コードのマニュアルからエラーの詳細情報を確認してください。これは MSDN ライブラリ (http://msdn.microsoft.com/library/ja) から入手できます。

使用例

非同期接続の試行を終了するコード例を次に示します。

C#

public static ManualResetEvent connectDone
 = 
    new ManualResetEvent(false);

public static void ConnectCallback(IAsyncResult
 ar)
{
    connectDone.Set();
    TcpClient t = (TcpClient)ar.AsyncState;
    t.EndConnect(ar);
}

C++

static ManualResetEvent^ connectDone = gcnew ManualResetEvent(
 false );
static void ConnectCallback( IAsyncResult^
 ar )
{
   connectDone->Set();
   TcpClient^ t = safe_cast<TcpClient^>(ar->AsyncState);
   t->EndConnect( ar );
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TcpClient クラス
TcpClient メンバ
System.Net.Sockets 名前空間