TcpClient.BeginConnect TcpClient.BeginConnect TcpClient.BeginConnect TcpClient.BeginConnect Method

定義

リモート ホスト接続への非同期要求を開始します。Begins an asynchronous request for a remote host connection.

オーバーロード

BeginConnect(IPAddress, Int32, AsyncCallback, Object) BeginConnect(IPAddress, Int32, AsyncCallback, Object) BeginConnect(IPAddress, Int32, AsyncCallback, Object) BeginConnect(IPAddress, Int32, AsyncCallback, Object)

リモート ホスト接続への非同期要求を開始します。Begins an asynchronous request for a remote host connection. リモート ホストは、IPAddress とポート番号 (Int32) で指定されます。The remote host is specified by an IPAddress and a port number (Int32).

BeginConnect(IPAddress[], Int32, AsyncCallback, Object) BeginConnect(IPAddress[], Int32, AsyncCallback, Object) BeginConnect(IPAddress[], Int32, AsyncCallback, Object) BeginConnect(IPAddress[], Int32, AsyncCallback, Object)

リモート ホスト接続への非同期要求を開始します。Begins an asynchronous request for a remote host connection. リモート ホストは、IPAddress 配列とポート番号 (Int32) で指定されます。The remote host is specified by an IPAddress array and a port number (Int32).

BeginConnect(String, Int32, AsyncCallback, Object) BeginConnect(String, Int32, AsyncCallback, Object) BeginConnect(String, Int32, AsyncCallback, Object) BeginConnect(String, Int32, AsyncCallback, Object)

リモート ホスト接続への非同期要求を開始します。Begins an asynchronous request for a remote host connection. リモート ホストは、ホスト名 (String) とポート番号 (Int32) で指定されます。The remote host is specified by a host name (String) and a port number (Int32).

BeginConnect(IPAddress, Int32, AsyncCallback, Object) BeginConnect(IPAddress, Int32, AsyncCallback, Object) BeginConnect(IPAddress, Int32, AsyncCallback, Object) BeginConnect(IPAddress, Int32, AsyncCallback, Object)

リモート ホスト接続への非同期要求を開始します。Begins an asynchronous request for a remote host connection. リモート ホストは、IPAddress とポート番号 (Int32) で指定されます。The remote host is specified by an IPAddress and a port number (Int32).

public:
 IAsyncResult ^ BeginConnect(System::Net::IPAddress ^ address, int port, AsyncCallback ^ requestCallback, System::Object ^ state);
public IAsyncResult BeginConnect (System.Net.IPAddress address, int port, AsyncCallback requestCallback, object state);
member this.BeginConnect : System.Net.IPAddress * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

address
IPAddress IPAddress IPAddress IPAddress

リモート ホストの IPAddressThe IPAddress of the remote host.

port
Int32 Int32 Int32 Int32

リモート ホストのポート番号。The port number of the remote host.

requestCallback
AsyncCallback AsyncCallback AsyncCallback AsyncCallback

操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。An AsyncCallback delegate that references the method to invoke when the operation is complete.

state
Object Object Object Object

接続操作に関する情報を格納するユーザー定義のオブジェクト。A user-defined object that contains information about the connect operation. このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。This object is passed to the requestCallback delegate when the operation is complete.

戻り値

非同期接続を参照する IAsyncResult オブジェクト。An IAsyncResult object that references the asynchronous connection.

例外

address パラメーターが null です。The address parameter is null.

ソケットへのアクセスを試行しているときにエラーが発生しました。An error occurred when attempting to access the socket.

コール スタックの上位にある呼び出し元が、要求された操作のアクセス許可を保持していません。A caller higher in the call stack does not have permission for the requested operation.

次のコード例を作成、TcpClientし、リモート ホストに接続します。The following code example creates a TcpClient and connects to a remote host.

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

注釈

非同期のBeginConnect操作を呼び出すことによって完了する必要があります、EndConnectメソッド。The asynchronous BeginConnect operation must be completed by calling the EndConnect method. 通常、メソッドは、によって呼び出される、asyncCallbackを委任します。Typically, the method is invoked by the asyncCallback delegate.

操作が完了するまで、このメソッドはブロックされません。This method does not block until the operation completes. 操作が完了するまでにブロックするのいずれかの操作を使用して、Connectメソッドのオーバー ロードします。To block until the operation completes, use one of the Connect method overloads.

詳細については、非同期プログラミング モデルを使用して、次を参照してください。 Calling Synchronous Methods Asynchronouslyします。For detailed information about using the asynchronous programming model, see Calling Synchronous Methods Asynchronously.

BeginConnect(IPAddress[], Int32, AsyncCallback, Object) BeginConnect(IPAddress[], Int32, AsyncCallback, Object) BeginConnect(IPAddress[], Int32, AsyncCallback, Object) BeginConnect(IPAddress[], Int32, AsyncCallback, Object)

リモート ホスト接続への非同期要求を開始します。Begins an asynchronous request for a remote host connection. リモート ホストは、IPAddress 配列とポート番号 (Int32) で指定されます。The remote host is specified by an IPAddress array and a port number (Int32).

public:
 IAsyncResult ^ BeginConnect(cli::array <System::Net::IPAddress ^> ^ addresses, int port, AsyncCallback ^ requestCallback, System::Object ^ state);
public IAsyncResult BeginConnect (System.Net.IPAddress[] addresses, int port, AsyncCallback requestCallback, object state);
member this.BeginConnect : System.Net.IPAddress[] * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

addresses
IPAddress[]

リモート ホストを指定する 1 つ以上の IPAddressAt least one IPAddress that designates the remote hosts.

port
Int32 Int32 Int32 Int32

リモート ホストのポート番号。The port number of the remote hosts.

requestCallback
AsyncCallback AsyncCallback AsyncCallback AsyncCallback

操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。An AsyncCallback delegate that references the method to invoke when the operation is complete.

state
Object Object Object Object

接続操作に関する情報を格納するユーザー定義のオブジェクト。A user-defined object that contains information about the connect operation. このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。This object is passed to the requestCallback delegate when the operation is complete.

戻り値

非同期接続を参照する IAsyncResult オブジェクト。An IAsyncResult object that references the asynchronous connection.

例外

addresses パラメーターが null です。The addresses parameter is null.

ソケットへのアクセスを試行しているときにエラーが発生しました。An error occurred when attempting to access the socket.

コール スタックの上位にある呼び出し元が、要求された操作のアクセス許可を保持していません。A caller higher in the call stack does not have permission for the requested operation.

次のコード例を作成、TcpClientし、リモート ホストに接続します。The following code example creates a TcpClient and connects to a remote host.

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

注釈

非同期のBeginConnect操作を呼び出すことによって完了する必要があります、EndConnectメソッド。The asynchronous BeginConnect operation must be completed by calling the EndConnect method. 通常、メソッドは、によって呼び出される、asyncCallbackを委任します。Typically, the method is invoked by the asyncCallback delegate.

操作が完了するまで、このメソッドはブロックされません。This method does not block until the operation completes. 操作が完了するまでにブロックするのいずれかの操作を使用して、Connectメソッドのオーバー ロードします。To block until the operation completes, use one of the Connect method overloads.

詳細については、非同期プログラミング モデルを使用して、次を参照してください。 Calling Synchronous Methods Asynchronouslyします。For detailed information about using the asynchronous programming model, see Calling Synchronous Methods Asynchronously.

このメソッドは通常の呼び出し後すぐに使用、BeginGetHostAddressesメソッドで、複数の IP アドレスを 1 つのホストに戻すことができます。This method is typically used immediately after a call to the BeginGetHostAddresses method, which can return multiple IP addresses for a single host.

BeginConnect(String, Int32, AsyncCallback, Object) BeginConnect(String, Int32, AsyncCallback, Object) BeginConnect(String, Int32, AsyncCallback, Object) BeginConnect(String, Int32, AsyncCallback, Object)

リモート ホスト接続への非同期要求を開始します。Begins an asynchronous request for a remote host connection. リモート ホストは、ホスト名 (String) とポート番号 (Int32) で指定されます。The remote host is specified by a host name (String) and a port number (Int32).

public:
 IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);
public IAsyncResult BeginConnect (string host, int port, AsyncCallback requestCallback, object state);
member this.BeginConnect : string * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

host
String String String String

リモート ホストの名前。The name of the remote host.

port
Int32 Int32 Int32 Int32

リモート ホストのポート番号。The port number of the remote host.

requestCallback
AsyncCallback AsyncCallback AsyncCallback AsyncCallback

操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。An AsyncCallback delegate that references the method to invoke when the operation is complete.

state
Object Object Object Object

接続操作に関する情報を格納するユーザー定義のオブジェクト。A user-defined object that contains information about the connect operation. このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。This object is passed to the requestCallback delegate when the operation is complete.

戻り値

非同期接続を参照する IAsyncResult オブジェクト。An IAsyncResult object that references the asynchronous connection.

例外

host パラメーターが null です。The host parameter is null.

ソケットへのアクセスを試行しているときにエラーが発生しました。An error occurred when attempting to access the socket.

コール スタックの上位にある呼び出し元が、要求された操作のアクセス許可を保持していません。A caller higher in the call stack does not have permission for the requested operation.

次のコード例を作成、TcpClientし、リモート ホストに接続します。The following code example creates a TcpClient and connects to a remote host.

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

注釈

非同期のBeginConnect操作を呼び出すことによって完了する必要があります、EndConnectメソッド。The asynchronous BeginConnect operation must be completed by calling the EndConnect method. 通常、メソッドは、によって呼び出される、asyncCallbackを委任します。Typically, the method is invoked by the asyncCallback delegate.

操作が完了するまで、このメソッドはブロックされません。This method does not block until the operation completes. 操作が完了するまでにブロックするのいずれかの操作を使用して、Connectメソッドのオーバー ロードします。To block until the operation completes, use one of the Connect method overloads.

詳細については、非同期プログラミング モデルを使用して、次を参照してください。 Calling Synchronous Methods Asynchronouslyします。For detailed information about using the asynchronous programming model, see Calling Synchronous Methods Asynchronously.

適用対象