Socket.Connect メソッド

リファレンス

定義

名前空間:: System.Net.Sockets

アセンブリ:: System.Net.Sockets.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

Connect(EndPoint)	リモートホストへの接続を確立します。
Connect(IPAddress, Int32)	リモートホストへの接続を確立します。ホストは、IP アドレスとポート番号で指定されます。
Connect(IPAddress[], Int32)	リモートホストへの接続を確立します。ホストは、IP アドレスの配列とポート番号で指定されます。
Connect(String, Int32)	リモートホストへの接続を確立します。ホストはホスト名とポート番号で指定されます。

Connect(EndPoint)

ソース:: Socket.cs

ソース:: Socket.cs

ソース:: Socket.cs

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

public:
 void Connect(System::Net::EndPoint ^ remoteEP);

public void Connect (System.Net.EndPoint remoteEP);

member this.Connect : System.Net.EndPoint -> unit

Public Sub Connect (remoteEP As EndPoint)

パラメーター

remoteEP: EndPoint

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

例外

ArgumentNullException

remoteEP が nullです。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

SecurityException

呼び出し履歴の上位にある呼び出し元には、要求された操作に対するアクセス許可がありません。

InvalidOperationException

Socket は Listen(Int32) を呼び出すことでリッスン状態になっています。

例

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

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

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

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

注釈

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

UDP などのコネクションレスプロトコルを使用している場合は、データの送受信前にを呼び出す Connect 必要はありません。と ReceiveFrom を使用SendToして、リモートホストと同期的に通信できます。を呼び出 Connectすと、指定された既定値以外のアドレスから到着したデータグラムはすべて破棄されます。既定のリモートホストをブロードキャストアドレスに設定する場合は、まずメソッドを呼び出し SetSocketOption 、ソケットオプションをに SocketOptionName.Broadcast設定する必要があります。または Connect 、 SocketExceptionをスローします。を受け取った場合は SocketException、プロパティを SocketException.ErrorCode 使用して特定のエラーコードを取得します。このコードを取得したら、エラーの詳細な説明については、Windows ソケットバージョン 2 API エラーコードのドキュメントを参照してください。

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

注意

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

注意

ソケットが以前に切断されている場合は、このメソッドを使用して接続を復元することはできません。再接続するには、非同期 BeginConnect メソッドのいずれかを使用します。これは、基になるプロバイダーの制限です。

Note

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

こちらもご覧ください

適用対象

Connect(IPAddress, Int32)

ソース:: Socket.cs

ソース:: Socket.cs

ソース:: Socket.cs

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

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

public void Connect (System.Net.IPAddress address, int port);

member this.Connect : System.Net.IPAddress * int -> unit

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

パラメーター

address: IPAddress

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

port: Int32

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

例外

ArgumentNullException

address が nullです。

ArgumentOutOfRangeException

ポート番号が無効です。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

NotSupportedException

このメソッドは、InterNetwork または InterNetworkV6 ファミリのソケットで有効です。

ArgumentException

address の長さが 0 です。

InvalidOperationException

Socket は Listen(Int32) を呼び出すことでリッスン状態になっています。

例

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

// Synchronous connect using IPAddress to resolve the 
// host name.
static void Connect1( String^ host, int port )
{
   array<IPAddress^>^IPs = Dns::GetHostAddresses( host );
   Socket^ s = gcnew Socket( AddressFamily::InterNetwork,SocketType::Stream,ProtocolType::Tcp );
   Console::WriteLine( "Establishing Connection to {0}", host );
   s->Connect( IPs[ 0 ], port );
   Console::WriteLine( "Connection established" );
}

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

注釈

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

UDP などのコネクションレスプロトコルを使用している場合は、データの送受信前にを呼び出す Connect 必要はありません。と ReceiveFrom を使用SendToして、リモートホストと同期的に通信できます。指定した既定値以外のアドレスから到着したデータグラムを呼び出 Connect すと、破棄されます。既定のリモートホストをブロードキャストアドレスに設定する場合は、まずメソッドを呼び出し SetSocketOption 、ソケットオプションをに SocketOptionName.Broadcast設定する必要があります。または Connect 、 SocketExceptionをスローします。を受け取った場合は SocketException、プロパティを SocketException.ErrorCode 使用して特定のエラーコードを取得します。このコードを取得したら、エラーの詳細な説明については、Windows ソケットバージョン 2 API エラーコードのドキュメントを参照してください。

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

注意

Note

適用対象

Connect(IPAddress[], Int32)

ソース:: Socket.cs

ソース:: Socket.cs

ソース:: Socket.cs

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

public:
 void Connect(cli::array <System::Net::IPAddress ^> ^ addresses, int port);

public void Connect (System.Net.IPAddress[] addresses, int port);

member this.Connect : System.Net.IPAddress[] * int -> unit

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

パラメーター

addresses: IPAddress[]

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

port: Int32

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

例外

ArgumentNullException

addresses が nullです。

ArgumentOutOfRangeException

ポート番号が無効です。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

NotSupportedException

ソケットがまたは InterNetworkV6 ファミリにInterNetworkありません。

ArgumentException

address の長さが 0 です。

InvalidOperationException

Socket は Listen(Int32) を呼び出すことでリッスン状態になっています。

例

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

// Synchronous connect using Dns.ResolveToAddresses to 
// resolve the host name.
static void Connect2( String^ host, int port )
{
   array<IPAddress^>^IPs = Dns::GetHostAddresses( host );
   Socket^ s = gcnew Socket( AddressFamily::InterNetwork,SocketType::Stream,ProtocolType::Tcp );
   Console::WriteLine( "Establishing Connection to {0}", host );
   s->Connect( IPs, port );
   Console::WriteLine( "Connection established" );
}

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

注釈

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

UDP などのコネクションレスプロトコルを使用している場合は、データの送受信前にを呼び出 Connect す必要はありません。と ReceiveFrom を使用SendToして、リモートホストと同期的に通信できます。指定した既定値以外のアドレスから到着したデータグラムを呼び出 Connect すと、破棄されます。既定のリモートホストをブロードキャストアドレスに設定する場合は、まずメソッドを呼び出し SetSocketOption 、ソケットオプションをに SocketOptionName.Broadcast設定する必要があります。または Connect 、を SocketExceptionスローします。を受け取った場合は SocketException、プロパティを SocketException.ErrorCode 使用して特定のエラーコードを取得します。このコードを取得したら、エラーの詳細な説明については、 Windows ソケットバージョン 2 API エラーコードのドキュメントを参照してください。

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

注意

ソケットが以前に切断されている場合は、このメソッドを使用して接続を復元することはできません。いずれかの非同期 BeginConnect メソッドを使用して再接続します。これは、基になるプロバイダーの制限です。

Note

適用対象

Connect(String, Int32)

ソース:: Socket.cs

ソース:: Socket.cs

ソース:: Socket.cs

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

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

public void Connect (string host, int port);

member this.Connect : string * int -> unit

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

パラメーター

host: String

リモートホストの名前。

port: Int32

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

例外

ArgumentNullException

host が nullです。

ArgumentOutOfRangeException

ポート番号が無効です。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

NotSupportedException

ソケットがまたは InterNetworkV6 ファミリにInterNetworkありません。

InvalidOperationException

Socket は Listen(Int32) を呼び出すことでリッスン状態になっています。

例

次のコード例では、リモートエンドポイントに接続し、接続を確認します。

// Synchronous connect using host name (resolved by the 
// Connect call.)
static void Connect3( String^ host, int port )
{
   Socket^ s = gcnew Socket( AddressFamily::InterNetwork,SocketType::Stream,ProtocolType::Tcp );
   Console::WriteLine( "Establishing Connection to {0}", host );
   s->Connect( host, port );
   Console::WriteLine( "Connection established" );
}

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

注釈

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

を呼び出すConnect前にプロパティfalseをに明示的に設定Blockingしない限り、メソッドはConnectブロックされます。 TCP のような接続指向プロトコルを使用していて、ブロッキングを無効にした場合、 Connect 接続を確立するのに時間が必要なため、がスロー SocketException されます。コネクションレスプロトコルは、単に既定のリモートホストを確立するため、例外をスローしません。を使用 SocketException.ErrorCode して、特定のエラーコードを取得できます。このコードを取得したら、エラーの詳細な説明については、 Windows ソケットバージョン 2 API エラーコードのドキュメントを参照してください。エラーから WSAEWOULDBLOCK が返された場合、リモートホスト接続は接続指向 Socketのによって開始されましたが、まだ正常に完了していません。メソッドを Poll 使用して、の接続が完了した日時を Socket 確認します。

IPv6 が有効で、メソッドが呼び出されて Connect(String, Int32) IPv6 アドレスと IPv4 アドレスの両方に解決されるホストに接続する場合、IPv4 アドレスの前に IPv6 アドレスへの接続が最初に試行されます。これは、ホストが IPv6 アドレスでリッスンしていない場合に、接続を確立する時間を遅らせる効果がある可能性があります。

注意

Note

適用対象

Socket.Connect メソッド

定義

オーバーロード

Connect(EndPoint)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

Connect(IPAddress, Int32)

パラメーター

例外

例

注釈

適用対象

Connect(IPAddress[], Int32)

パラメーター

例外

例

注釈

適用対象

Connect(String, Int32)

パラメーター

例外

例

注釈

適用対象

フィードバック

その他のリソース