TcpClient.BeginConnectとは何？わかりやすく解説 Weblio辞書

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

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

TcpClient.BeginConnect メソッド (IPAddress, Int32, AsyncCallback, Object)

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

リモートホスト接続への非同期要求を開始します。リモートホストは、IPAddress とポート番号 (Int32) で指定されます。

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

Visual Basic (宣言)

Public Function BeginConnect ( _
    address As IPAddress, _
    port As Integer, _
    requestCallback As AsyncCallback, _
    state As Object _
) As IAsyncResult

Visual Basic (使用法)

Dim instance As TcpClient
Dim address As IPAddress
Dim port As Integer
Dim requestCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult

returnValue = instance.BeginConnect(address, port, requestCallback, state)

public IAsyncResult BeginConnect (
    IPAddress address,
    int port,
    AsyncCallback requestCallback,
    Object state
)

C++

public:
IAsyncResult^ BeginConnect (
    IPAddress^ address, 
    int port, 
    AsyncCallback^ requestCallback, 
    Object^ state
)

public IAsyncResult BeginConnect (
    IPAddress address, 
    int port, 
    AsyncCallback requestCallback, 
    Object state
)

JScript

public function BeginConnect (
    address : IPAddress, 
    port : int, 
    requestCallback : AsyncCallback, 
    state : Object
) : IAsyncResult

パラメータ

address: リモートホストの IPAddress。

port: リモートホストのポート番号。

requestCallback: 操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。

state: 接続操作に関する情報を格納するユーザー定義のオブジェクト。このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。

戻り値
非同期接続を参照する IAsyncResult オブジェクト。

例外

例外の種類	条件
ArgumentNullException	address パラメータが null 参照 (Visual Basic では Nothing) です。
SocketException	ソケットへのアクセスを試みているときにエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	Socket は閉じられています。
SecurityException	コールスタックの上位にある呼び出し元が、要求された操作のアクセス許可を保持していません。
ArgumentOutOfRangeException	ポート番号が無効です。

解説

非同期の BeginConnect 操作は、EndConnect メソッドを呼び出して終了させる必要があります。通常、このメソッドは asyncCallback デリゲートによって呼び出されます。

このメソッドは、操作が完了するまでブロックしません。操作が完了するまでブロックするには、Connect メソッドオーバーロードのいずれかを使用します。

非同期プログラミングモデルの使用法の詳細については、「同期メソッドの非同期呼び出し」を参照してください。

使用例

TcpClient を作成してリモートホストに接続するコード例を次に示します。

        public static void DoBeginConnect1(string
 host, int port)
        {
            // Connect asynchronously to the specifed host.
            TcpClient t = new TcpClient(AddressFamily.InterNetwork);
//            IPAddress remoteHost = new IPAddress(host);
            IPAddress[] remoteHost = Dns.GetHostAddresses(host);

            connectDone.Reset();

            Console.WriteLine("Establishing Connection to {0}", 
                remoteHost[0]);
            t.BeginConnect(remoteHost[0], port, 
                new AsyncCallback(ConnectCallback), t);

            // Wait here until the callback processes the connection.
            connectDone.WaitOne();

            Console.WriteLine("Connection established");
        }

C++

   static void DoBeginConnect1( String^ host,
 int port )
   {
      // Connect asynchronously to the specifed host.
      TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
//      IPAddress^ remoteHost = gcnew IPAddress( host );
      array<IPAddress^>^ remoteHost = Dns::GetHostAddresses( host );
      connectDone->Reset();
      Console::WriteLine( "Establishing Connection to {0}", host );
      t->BeginConnect( remoteHost, port, gcnew AsyncCallback( &ConnectCallback
 ), t );

      // Wait here until the callback processes the connection.
      connectDone->WaitOne();
      Console::WriteLine( "Connection established" );
   }

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

TcpClient.BeginConnect メソッド (IPAddress[], Int32, AsyncCallback, Object)

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

リモートホスト接続への非同期要求を開始します。リモートホストは、IPAddress 配列とポート番号 (Int32) で指定されます。

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

Visual Basic (宣言)

Public Function BeginConnect ( _
    addresses As IPAddress(), _
    port As Integer, _
    requestCallback As AsyncCallback, _
    state As Object _
) As IAsyncResult

Visual Basic (使用法)

Dim instance As TcpClient
Dim addresses As IPAddress()
Dim port As Integer
Dim requestCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult

returnValue = instance.BeginConnect(addresses, port, requestCallback, state)

public IAsyncResult BeginConnect (
    IPAddress[] addresses,
    int port,
    AsyncCallback requestCallback,
    Object state
)

C++

public:
IAsyncResult^ BeginConnect (
    array<IPAddress^>^ addresses, 
    int port, 
    AsyncCallback^ requestCallback, 
    Object^ state
)

public IAsyncResult BeginConnect (
    IPAddress[] addresses, 
    int port, 
    AsyncCallback requestCallback, 
    Object state
)

JScript

public function BeginConnect (
    addresses : IPAddress[], 
    port : int, 
    requestCallback : AsyncCallback, 
    state : Object
) : IAsyncResult

パラメータ

addresses: リモートホストを指定する 1 つ以上の IPAddress。

port: リモートホストのポート番号。

requestCallback: 操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。

state: 接続操作に関する情報を格納するユーザー定義のオブジェクト。このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。

戻り値
非同期接続を参照する IAsyncResult オブジェクト。

例外

例外の種類	条件
ArgumentNullException	addresses パラメータが null 参照 (Visual Basic では Nothing) です。
SocketException	ソケットへのアクセスを試みているときにエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	Socket は閉じられています。
SecurityException	コールスタックの上位にある呼び出し元が、要求された操作のアクセス許可を保持していません。
ArgumentOutOfRangeException	ポート番号が無効です。

解説

非同期の BeginConnect 操作は、EndConnect メソッドを呼び出して終了させる必要があります。通常、このメソッドは asyncCallback デリゲートによって呼び出されます。

非同期プログラミングモデルの使用法の詳細については、「同期メソッドの非同期呼び出し」を参照してください。

通常、このメソッドは ResolveToAddresses メソッドを呼び出した直後に使用され、単一のホストに対する複数の IP アドレスを返すことができます。

使用例

TcpClient を作成してリモートホストに接続するコード例を次に示します。

// Connect asynchronously to the specifed host.
public static void DoBeginConnect2(string
 host, int port)
{
    TcpClient t = new TcpClient(AddressFamily.InterNetwork);
    IPAddress[] remoteHost = Dns.GetHostAddresses(host);

    connectDone.Reset();

    Console.WriteLine("Establishing Connection to {0}", host);
    t.BeginConnect(remoteHost, port, 
        new AsyncCallback(ConnectCallback), t);

    // Wait here until the callback processes the connection.
    connectDone.WaitOne();

    Console.WriteLine("Connection established");
}

C++

// Connect asynchronously to the specifed host.
static void DoBeginConnect2( String^ host,
 int port )
{
   TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
   array<IPAddress^>^remoteHost = Dns::GetHostAddresses( host );
   connectDone->Reset();
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->BeginConnect( remoteHost, port, gcnew AsyncCallback(  &ConnectCallback
 ), t );

   // Wait here until the callback processes the connection.
   connectDone->WaitOne();
   Console::WriteLine( "Connection established" );
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

TcpClient.BeginConnect メソッド

リモートホスト接続への非同期要求を開始します。
オーバーロードの一覧

名前	説明
TcpClient.BeginConnect (IPAddress, Int32, AsyncCallback, Object)	リモートホスト接続への非同期要求を開始します。リモートホストは、IPAddress とポート番号 (Int32) で指定されます。
TcpClient.BeginConnect (IPAddress[], Int32, AsyncCallback, Object)	リモートホスト接続への非同期要求を開始します。リモートホストは、IPAddress 配列とポート番号 (Int32) で指定されます。
TcpClient.BeginConnect (String, Int32, AsyncCallback, Object)	リモートホスト接続への非同期要求を開始します。リモートホストは、ホスト名 (String) とポート番号 (Int32) で指定されます。

参照

TcpClient.BeginConnect メソッド (String, Int32, AsyncCallback, Object)

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

リモートホスト接続への非同期要求を開始します。リモートホストは、ホスト名 (String) とポート番号 (Int32) で指定されます。

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

Visual Basic (宣言)

Public Function BeginConnect ( _
    host As String, _
    port As Integer, _
    requestCallback As AsyncCallback, _
    state As Object _
) As IAsyncResult

Visual Basic (使用法)

Dim instance As TcpClient
Dim host As String
Dim port As Integer
Dim requestCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult

returnValue = instance.BeginConnect(host, port, requestCallback, state)

public IAsyncResult BeginConnect (
    string host,
    int port,
    AsyncCallback requestCallback,
    Object state
)

C++

public:
IAsyncResult^ BeginConnect (
    String^ host, 
    int port, 
    AsyncCallback^ requestCallback, 
    Object^ state
)

public IAsyncResult BeginConnect (
    String host, 
    int port, 
    AsyncCallback requestCallback, 
    Object state
)

JScript

public function BeginConnect (
    host : String, 
    port : int, 
    requestCallback : AsyncCallback, 
    state : Object
) : IAsyncResult

パラメータ

host: リモートホストの名前。

port: リモートホストのポート番号。

requestCallback: 操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。

state: 接続操作に関する情報を格納するユーザー定義のオブジェクト。このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。

戻り値
非同期接続を参照する IAsyncResult オブジェクト。

例外

例外の種類	条件
ArgumentNullException	host パラメータが null 参照 (Visual Basic では Nothing) です。
SocketException	ソケットへのアクセスを試みているときにエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	Socket は閉じられています。
SecurityException	コールスタックの上位にある呼び出し元が、要求された操作のアクセス許可を保持していません。
ArgumentOutOfRangeException	ポート番号が無効です。

解説

非同期プログラミングモデルの使用法の詳細については、「同期メソッドの非同期呼び出し」を参照してください。

使用例

TcpClient を作成してリモートホストに接続するコード例を次に示します。

// Connect asynchronously to the specifed host.
public static void DoBeginConnect3(string
 host, int port)
{
    TcpClient t = new TcpClient(AddressFamily.InterNetwork);

    connectDone.Reset();

    Console.WriteLine("Establishing Connection to {0}", 
        host);
    t.BeginConnect(host, port, 
        new AsyncCallback(ConnectCallback), t);

    // Wait here until the callback processes the connection.
    connectDone.WaitOne();

    Console.WriteLine("Connection established");
}

C++

// Connect asynchronously to the specifed host.
static void DoBeginConnect3( String^ host,
 int port )
{
   TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
   connectDone->Reset();
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->BeginConnect( host, port, gcnew AsyncCallback(  &ConnectCallback ),
 t );
   
   // Wait here until the callback processes the connection.
   connectDone->WaitOne();
   Console::WriteLine( "Connection established" );
}