UdpClient.Connect メソッド

定義

名前空間:: System.Net.Sockets

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

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

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

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

既定のリモートホストを確立します。

オーバーロード

名前	説明
Connect(IPEndPoint)	指定したネットワークエンドポイントを使用して、既定のリモートホストを確立します。
Connect(IPAddress, Int32)	指定した IP アドレスとポート番号を使用して、既定のリモートホストを確立します。
Connect(String, Int32)	指定したホスト名とポート番号を使用して、既定のリモートホストを確立します。

Connect(IPEndPoint)

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

指定したネットワークエンドポイントを使用して、既定のリモートホストを確立します。

public:
 void Connect(System::Net::IPEndPoint ^ endPoint);

public void Connect(System.Net.IPEndPoint endPoint);

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

Public Sub Connect (endPoint As IPEndPoint)

パラメーター

endPoint: IPEndPoint

データの送信先となるネットワークエンドポイントを指定する IPEndPoint 。

例外

SocketException

ソケットにアクセスするときにエラーが発生しました。

ArgumentNullException

endPoint は nullです。

ObjectDisposedException

UdpClient は閉じられます。

例

次の例では、 IPEndPoint を使用して既定のリモートホストを確立します。

//Uses a remote endpoint to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);
try{
 udpClient.Connect(ipEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

'Uses a remote endpoint to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)
Try
   udpClient.Connect(ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注釈

Connect メソッドは、endPoint パラメーターで指定された値を使用して、既定のリモートホストを確立します。確立されたら、 Send メソッドの各呼び出しでリモートホストを指定する必要はありません。

既定のリモートホストの確立は省略可能です。既定のリモートホストを指定すると、そのホストのみに制限されます。データグラムを別のリモートホストに送信する場合は、 Connect メソッドを別の呼び出しで呼び出すか、既定のリモートホストを使用せずに別の UdpClient を作成する必要があります。既定のリモートホストを確立し、 Send メソッドの呼び出しでリモートホストも指定した場合、 Send は SocketExceptionをスローします。 SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラーコードを取得します。このコードを取得したら、エラーの詳細な説明については、 Windows ソケットバージョン 2 API のエラーコードドキュメントを参照してください。

Connect メソッドを呼び出すと、指定した既定値以外のアドレスから到着したデータグラムは破棄されます。 UdpClientから継承し、Client メソッドを使用して基になるSocketを取得し、ソケットオプションを SocketOptionName.Broadcast に設定しない限り、このメソッドを使用して既定のリモートホストをブロードキャストアドレスに設定することはできません。

ただし、IPAddress.Broadcast メソッドの呼び出しでSendを指定した場合は、既定のブロードキャストアドレス 255.255.255.255 にデータをブロードキャストできます。アプリケーションでブロードキャストアドレスをより詳細に制御する必要がある場合は、 Socket クラスの使用に戻すこともできます。

Note

UDP プロトコルはコネクションレスであるため、 Connect メソッドはブロックしません。マルチキャストされたデータグラムを受信する場合は、 Connect メソッドを呼び出さないでください。

こちらもご覧ください

適用対象

Connect(IPAddress, Int32)

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

指定した IP アドレスとポート番号を使用して、既定のリモートホストを確立します。

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

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

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

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

パラメーター

addr: IPAddress

データの送信先となるリモートホストの IPAddress 。

port: Int32

データを送信するポート番号。

例外

ObjectDisposedException

UdpClient は閉じています。

ArgumentNullException

addr は nullです。

ArgumentOutOfRangeException

port が MinPort と MaxPortの間ではありません。

SocketException

ソケットにアクセスするときにエラーが発生しました。

例

次の例では、IP アドレスとポート番号を使用してリモートホストに接続します。

//Uses the IP address and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
try{
    udpClient.Connect(ipAddress, 11003);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Uses the IP address and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Try
   udpClient.Connect(ipAddress, 11003)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注釈

Connect メソッドは、addrパラメーターと port パラメーターで指定された値を使用して、既定のリモートホストを確立します。確立されたら、 Send メソッドの各呼び出しでリモートホストを指定する必要はありません。

Connect メソッドを呼び出すと、指定した既定値以外のアドレスから到着したデータグラムは破棄されます。 UdpClientから継承し、クライアントメソッドを使用して基になるSocketを取得し、ソケットオプションを SocketOptionName.Broadcast に設定しない限り、このメソッドを使用して既定のリモートホストをブロードキャストアドレスに設定することはできません。

Note

こちらもご覧ください

適用対象

Connect(String, Int32)

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

ソース:: UDPClient.cs

指定したホスト名とポート番号を使用して、既定のリモートホストを確立します。

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

public void Connect(string hostname, int port);

member this.Connect : string * int -> unit

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

パラメーター

hostname: String

データの送信先となるリモートホストの DNS 名。

port: Int32

データの送信先となるリモートホスト上のポート番号。

例外

ObjectDisposedException

UdpClient は閉じられます。

ArgumentOutOfRangeException

port が MinPort と MaxPortの間ではありません。

SocketException

ソケットにアクセスするときにエラーが発生しました。

例

次の例では、ホスト名とポート番号を使用してリモートホストに接続します。

 //Uses a host name and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
try{
    udpClient.Connect("www.contoso.com", 11002);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

'Uses a host name and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Try
   udpClient.Connect("www.contoso.com", 11002)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注釈

Connect メソッドは、portパラメーターと hostname パラメーターで指定された値を使用して、既定のリモートホストを確立します。確立されたら、 Send メソッドの各呼び出しでリモートホストを指定する必要はありません。

既定のリモートホストの確立は省略可能です。既定のリモートホストを指定すると、そのホストのみに制限されます。データグラムを別のリモートホストに送信する場合は、 Connect メソッドを別の呼び出しで呼び出すか、既定のリモートホストを使用せずに別の UdpClient を作成する必要があります。

既定のリモートホストを確立し、 Send メソッドの呼び出しでリモートホストも指定した場合、 Send は SocketExceptionをスローします。 SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラーコードを取得します。このコードを取得したら、エラーの詳細な説明については、 Windows ソケットバージョン 2 API のエラーコードドキュメントを参照してください。

Note

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?