TcpClient.BeginConnect

.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)

C#

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

C++

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

J#

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 を作成してリモートホストに接続するコード例を次に示します。

C#

        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" );
   }

プラットフォーム

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 名前空間

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)

C#

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

C++

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

J#

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 デリゲートによって呼び出されます。

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

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

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

使用例

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

C#

// 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" );
}

プラットフォーム

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 名前空間

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 クラス
TcpClient メンバ
System.Net.Sockets 名前空間

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)

C#

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

C++

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

J#

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	ポート番号が無効です。

解説

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

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

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

使用例

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

C#

// 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" );
}

プラットフォーム

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 名前空間