socket_connectとは何？わかりやすく解説 Weblio辞書

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

socket_connect

(PHP 4 >= 4.0.7, PHP 5)
socket_connect — ソケット上の接続を初期化する

説明

bool socket_connect ( resource socket, string address [, int port] )
ソケット記述子 socket を用いて接続を初期化します。この記述子は、socket_create() で作成した有効なソケット記述子である必要があります。
パラメータaddress には、ソケットの種類が AF_INET の場合はドット区切り表記の IP アドレス（例: 127.0.0.1）、 AF_UNIX の場合は Unix ドメインソケットのパス名を指定します。
パラメータ port は AF_INET ソケットに接続する場合にのみ使用され、接続するリモートホストのポートを指定します。
成功した場合に TRUE を、失敗した場合に FALSE を返します。エラーコードは、 socket_last_error() により取得できます。このコードを socket_strerror() に渡すことにより、エラー内容を表すテキストを得ることができます。
socket_bind()、 socket_listen()、 socket_create()、 socket_last_error() および socket_strerror() も参照ください。

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

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

Socket.Connect メソッド (IPAddress[], Int32)

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

リモートホストへの接続を確立します。ホストは、IP アドレスとポート番号の配列で指定されます。

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

Visual Basic (宣言)

Public Sub Connect ( _
    addresses As IPAddress(), _
    port As Integer _
)

Visual Basic (使用法)

Dim instance As Socket
Dim addresses As IPAddress()
Dim port As Integer

instance.Connect(addresses, port)

public void Connect (
    IPAddress[] addresses,
    int port
)

C++

public:
void Connect (
    array<IPAddress^>^ addresses, 
    int port
)

public void Connect (
    IPAddress[] addresses, 
    int port
)

JScript

public function Connect (
    addresses : IPAddress[], 
    port : int
)

パラメータ

addresses: リモートホストの IP アドレス。

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

例外

例外の種類	条件
ArgumentNullException	addresses が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	ポート番号が無効です。
SocketException	ソケットへのアクセスを試みているときにエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	Socket は閉じられています。
NotSupportedException	このメソッドは、InterNetwork または InterNetworkV6 ファミリのソケットで有効です。
ArgumentException	address の長さが 0 です。
InvalidOperationException	Socket が Listen を実行中です。

解説

通常、このメソッドは GetHostAddresses を呼び出した直後に使用され、単一のホストに対する複数の IP アドレスを返すことができます。TCP などのコネクション指向のプロトコルを使用している場合、Connect メソッドは LocalEndPoint と指定したリモートエンドポイント間のネットワーク接続を同期的に確立します。コネクションレスのプロトコルを使用している場合、Connect は既定のリモートホストを確立します。Connect を呼び出したら、Send メソッドを使用してリモートデバイスにデータを送信できます。また、Receive メソッドを使用してリモートデバイスからデータを受信することもできます。

UDP などのコネクションレスのプロトコルを使用している場合は、データを送受信する前に Connect を呼び出す必要はありません。リモートホストとの同期通信には、SendTo および ReceiveFrom を使用できます。Connect を呼び出した場合、指定した既定のアドレス以外から送信されたデータグラムはすべて破棄されます。既定のリモートホストをブロードキャストアドレスに設定する場合は、最初に SetSocketOption メソッドを呼び出し、ソケットオプションを SocketOptionName.Broadcast に設定する必要があります。このように設定しないと、Connect は SocketException をスローします。SocketException が発生した場合は、SocketException.ErrorCode プロパティを使用して具体的なエラーコードを取得してください。このコードを取得したら、Windows Socket Version 2 API エラーコードのマニュアルからエラーの詳細情報を確認してください。これは MSDN ライブラリから入手できます。

Connect を呼び出す前に Blocking プロパティを false に設定しないと、Connect メソッドはブロックします。TCP などのコネクション指向のプロトコルを使用しており、ブロックを無効にしている場合、Connect には接続を確立するための時間が必要です。このため、SocketException をスローします。一方、コネクションレスのプロトコルは、既定のリモートホストを確立するだけであるため、例外をスローしません。SocketException.ErrorCode を使用すると、特定のエラーコードを取得できます。このコードを取得したら、Windows Socket Version 2 API エラーコードのドキュメントでエラーの詳細情報を確認してください。これは MSDN ライブラリから入手できます。エラーが WSAEWOULDBLOCK を返した場合、リモートホスト接続はコネクション指向の Socket によって開始されていますが、正常に完了していません。Poll メソッドを使用して、Socket がいつ接続を完了するかを確認します。

メモ
コネクション指向のプロトコルを使用しており、Connect の前に Bind を呼び出さなかった場合は、基になるサービスプロバイダがローカルネットワークアドレスとポート番号を割り当てます。コネクションレスのプロトコルを使用している場合は、送受信操作を完了するまで、サービスプロバイダはローカルネットワークアドレスとポート番号を割り当てません。既定のリモートホストを変更する必要がある場合は、必要なエンドポイントで Connect を再度呼び出します。

メモ

コネクション指向のプロトコルを使用しており、Connect の前に Bind を呼び出さなかった場合は、基になるサービスプロバイダがローカルネットワークアドレスとポート番号を割り当てます。コネクションレスのプロトコルを使用している場合は、送受信操作を完了するまで、サービスプロバイダはローカルネットワークアドレスとポート番号を割り当てません。既定のリモートホストを変更する必要がある場合は、必要なエンドポイントで Connect を再度呼び出します。

メモ
ソケットの接続が既に解除されていた場合、このメソッドを使って接続を復元することはできません。いずれかの非同期 BeginConnect メソッドを使用して再接続してください。これは、基になるプロバイダの制限です。

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

使用例

リモートエンドポイントに接続し、接続を検証するコード例を次に示します。

// Synchronous connect using Dns.GetHostAddresses to 
// resolve the host name.
public static void Connect2(string
 host, int port)
{
    IPAddress[] IPs = Dns.GetHostAddresses(host);

    Socket s = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream,
        ProtocolType.Tcp);
    Console.WriteLine("Establishing Connection to {0}", 
        host);
    s.Connect(IPs, port);
    Console.WriteLine("Connection established");
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

Socket.Connect メソッド (IPAddress, Int32)

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

リモートホストへの接続を確立します。ホストは、IP アドレスとポート番号で指定されます。

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

Visual Basic (宣言)

Public Sub Connect ( _
    address As IPAddress, _
    port As Integer _
)

Visual Basic (使用法)

Dim instance As Socket
Dim address As IPAddress
Dim port As Integer

instance.Connect(address, port)

public void Connect (
    IPAddress address,
    int port
)

C++

public:
void Connect (
    IPAddress^ address, 
    int port
)

public void Connect (
    IPAddress address, 
    int port
)

JScript

public function Connect (
    address : IPAddress, 
    port : int
)

パラメータ

address: リモートホストの IP アドレス。

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

例外

例外の種類	条件
ArgumentNullException	address が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	ポート番号が無効です。
SocketException	ソケットへのアクセスを試みているときにエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	Socket は閉じられています。
NotSupportedException	このメソッドは、InterNetwork または InterNetworkV6 ファミリのソケットで有効です。
ArgumentException	address の長さが 0 です。
InvalidOperationException	Socket が Listen を実行中です。

解説

TCP などのコネクション指向のプロトコルを使用している場合、Connect メソッドは LocalEndPoint と指定したリモートエンドポイント間のネットワーク接続を同期的に確立します。コネクションレスのプロトコルを使用している場合、Connect は既定のリモートホストを確立します。Connect を呼び出したら、Send メソッドを使用してリモートデバイスにデータを送信できます。また、Receive メソッドを使用してリモートデバイスからデータを受信することもできます。

メモ
コネクション指向のプロトコルを使用しており、Connect の前に Bind を呼び出さなかった場合は、基になるサービスプロバイダがローカルネットワークアドレスとポート番号を割り当てます。コネクションレスのプロトコルを使用している場合は、送受信操作を完了するまで、サービスプロバイダはローカルネットワークアドレスとポート番号を割り当てません。既定のリモートホストを変更する必要がある場合は、必要なエンドポイントで Connect を再度呼び出します。

メモ

メモ
ソケットの接続が既に解除されていた場合、このメソッドを使って接続を復元することはできません。いずれかの非同期 BeginConnect メソッドを使用して再接続してください。これは、基になるプロバイダの制限です。

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

使用例

リモートエンドポイントに接続し、接続を検証するコード例を次に示します。

// Synchronous connect using IPAddress to resolve the 
// host name.
public static void Connect1(string
 host, int port)
{
    IPAddress[] IPs = Dns.GetHostAddresses(host);

    Socket s = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream,
        ProtocolType.Tcp);
 
    Console.WriteLine("Establishing Connection to {0}", 
        host);
    s.Connect(IPs[0], port);
    Console.WriteLine("Connection established");
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

Socket.Connect メソッド (String, Int32)

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

リモートホストへの接続を確立します。ホストは、ホスト名とポート番号で指定されます。

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

Visual Basic (宣言)

Public Sub Connect ( _
    host As String, _
    port As Integer _
)

Visual Basic (使用法)

Dim instance As Socket
Dim host As String
Dim port As Integer

instance.Connect(host, port)

public void Connect (
    string host,
    int port
)

C++

public:
void Connect (
    String^ host, 
    int port
)

public void Connect (
    String host, 
    int port
)

JScript

public function Connect (
    host : String, 
    port : int
)

パラメータ

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

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

例外

例外の種類	条件
ArgumentNullException	host が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	ポート番号が無効です。
SocketException	ソケットへのアクセスを試みているときにエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	Socket は閉じられています。
NotSupportedException	このメソッドは、InterNetwork または InterNetworkV6 ファミリのソケットで有効です。
InvalidOperationException	Socket が Listen を実行中です。

解説

TCP などのコネクション指向のプロトコルを使用している場合、Connect メソッドは LocalEndPoint と指定したリモートホスト間のネットワーク接続を同期的に確立します。コネクションレスのプロトコルを使用している場合、Connect は既定のリモートホストを確立します。Connect を呼び出したら、Send メソッドを使用してリモートデバイスにデータを送信できます。また、Receive メソッドを使用してリモートデバイスからデータを受信することもできます。

メモ
コネクション指向のプロトコルを使用しており、Connect の前に Bind を呼び出さなかった場合は、基になるサービスプロバイダがローカルネットワークアドレスとポート番号を割り当てます。コネクションレスのプロトコルを使用している場合は、送受信操作を完了するまで、サービスプロバイダはローカルネットワークアドレスとポート番号を割り当てません。既定のリモートホストを変更する必要がある場合は、必要なエンドポイントで Connect を再度呼び出します。

メモ

メモ
ソケットの接続が既に解除されていた場合、このメソッドを使って接続を復元することはできません。いずれかの非同期 BeginConnect メソッドを使用して再接続してください。これは、基になるプロバイダの制限です。

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

使用例

リモートエンドポイントに接続し、接続を検証するコード例を次に示します。

// Synchronous connect using host name (resolved by the 
// Connect call.)
public static void Connect3(string
 host, int port)
{
    Socket s = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream,
        ProtocolType.Tcp);

    Console.WriteLine("Establishing Connection to {0}", 
        host);
    s.Connect(host, port);
    Console.WriteLine("Connection established");
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

Socket.Connect メソッド

リモートホストへの接続を確立します。
オーバーロードの一覧

名前	説明
Socket.Connect (EndPoint)	リモートホストへの接続を確立します。 .NET Compact Framework によってサポートされています。
Socket.Connect (IPAddress, Int32)	リモートホストへの接続を確立します。ホストは、IP アドレスとポート番号で指定されます。
Socket.Connect (IPAddress[], Int32)	リモートホストへの接続を確立します。ホストは、IP アドレスとポート番号の配列で指定されます。
Socket.Connect (String, Int32)	リモートホストへの接続を確立します。ホストは、ホスト名とポート番号で指定されます。

参照

Socket.Connect メソッド (EndPoint)

リモートホストへの接続を確立します。

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

Visual Basic (宣言)

Public Sub Connect ( _
    remoteEP As EndPoint _
)

Visual Basic (使用法)

Dim instance As Socket
Dim remoteEP As EndPoint

instance.Connect(remoteEP)

public void Connect (
    EndPoint remoteEP
)

C++

public:
void Connect (
    EndPoint^ remoteEP
)

public void Connect (
    EndPoint remoteEP
)

JScript

public function Connect (
    remoteEP : EndPoint
)

パラメータ

remoteEP: リモートデバイスを表す EndPoint。

例外

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

解説

メモ
コネクション指向のプロトコルを使用しており、Connect の前に Bind を呼び出さなかった場合は、基になるサービスプロバイダがローカルネットワークアドレスとポート番号を割り当てます。コネクションレスのプロトコルを使用している場合は、送受信操作を完了するまで、サービスプロバイダはローカルネットワークアドレスとポート番号を割り当てません。既定のリモートホストを変更する必要がある場合は、必要なエンドポイントで Connect を再度呼び出します。

メモ

メモ
ソケットの接続が既に解除されていた場合、このメソッドを使って接続を復元することはできません。いずれかの非同期 BeginConnect メソッドを使用して再接続してください。これは、基になるプロバイダの制限です。

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

使用例

リモートエンドポイントに接続し、接続を検証するコード例を次に示します。

Visual Basic

    ' .Connect throws an exception if unsuccessful
    client.Connect(anEndPoint)
    
    ' This is how you can determine whether a socket is still connected.
    Dim blockingState As Boolean
 = client.Blocking
    Try
        Dim tmp(0) As Byte
        
        client.Blocking = False
        client.Send(tmp, 0, 0)
        Console.WriteLine("Connected!")
    Catch e As SocketException
        ' 10035 == WSAEWOULDBLOCK
        If e.NativeErrorCode.Equals(10035) Then
            Console.WriteLine("Still Connected, but the Send would
 block")
        Else
            Console.WriteLine("Disconnected: error code {0}!",
 e.NativeErrorCode)
        End If
    Finally
        client.Blocking = blockingState
    End Try
    
    Console.WriteLine("Connected: {0}", client.Connected)

End Sub 'ConnectAndCheck

// .Connect throws an exception if unsuccessful
client.Connect(anEndPoint);

// This is how you can determine whether a socket is still connected.
bool blockingState = client.Blocking;
try
{
    byte [] tmp = new byte[1];

    client.Blocking = false;
    client.Send(tmp, 0, 0);
    Console.WriteLine("Connected!");
}
catch (SocketException e) 
{
    // 10035 == WSAEWOULDBLOCK
    if (e.NativeErrorCode.Equals(10035))
        Console.WriteLine("Still Connected, but the Send would block");
    else
    {
        Console.WriteLine("Disconnected: error code {0}!", e.NativeErrorCode);
    }
}
finally
{
    client.Blocking = blockingState;
}

 Console.WriteLine("Connected: {0}", client.Connected);

C++

client->Connect( anEndPoint );
if (  !client->Connected )
{
   Console::WriteLine( "Winsock error: {0}", Convert::ToString(
      System::Runtime::InteropServices::Marshal::GetLastWin32Error() ) );
}
   
// This is how you can determine whether a socket is still connected.
bool blockingState = client->Blocking;
try
{
   array<Byte>^tmp = gcnew array<Byte>(1);
   client->Blocking = false;
   client->Send( tmp, 0, static_cast<SocketFlags>(0) );
   Console::WriteLine( L"Connected!" );
}
catch ( SocketException^ e ) 
{
   // 10035 == WSAEWOULDBLOCK
   if ( e->NativeErrorCode.Equals( 10035 ) )
   {
      Console::WriteLine( "Connected from an exception!" );
   }
   else
   {
      Console::WriteLine( "Disconnected: {0}!", e->NativeErrorCode );
   }
}
finally
{
   client->Blocking = blockingState;
}

Console::WriteLine( "Connected: {0}", client->Connected );