Socket.Connect メソッドとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

.NET Framework のセキュリティ

SocketPermission (リモートホストに接続するために必要なアクセス許可)NetworkAccess.Connect (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Socket クラス
Socket メンバ
System.Net.Sockets 名前空間
Send
SendTo
Receive
ReceiveFrom
LocalEndPoint
SetSocketOption
Blocking
Poll

このページでは「.NET Framework クラスライブラリリファレンス」からSocket.Connect メソッドを検索した結果を表示しています。
Weblioに収録されているすべての辞書からSocket.Connect メソッドを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からSocket.Connect メソッドを検索