UdpClient.Connect メソッド

リファレンス

定義

名前空間:: System.Net.Sockets

アセンブリ:: 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

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

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 = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
try
{
   udpClient->Connect( ipEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//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 Sockets バージョン 2 API エラーコードのドキュメントを参照してください。

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

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

注意

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

こちらもご覧ください

適用対象

Connect(IPAddress, Int32)

ソース:: 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 = gcnew 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.
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、パラメーターと port パラメーターで指定された値を使用して、既定のリモートホストをaddr確立します。確立されると、メソッドの各呼び出しでリモートホストを指定する Send 必要はありません。

注意

こちらもご覧ください

適用対象

Connect(String, Int32)

ソース:: 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 = gcnew 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.
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、パラメーターと hostname パラメーターで指定された値を使用して、既定のリモートホストをport確立します。確立されると、メソッドの各呼び出しでリモートホストを指定する Send 必要はありません。

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

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

注意

こちらもご覧ください

適用対象

次の方法で共有

UdpClient.Connect メソッド

定義

オーバーロード

Connect(IPEndPoint)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

Connect(IPAddress, Int32)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

Connect(String, Int32)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース