UdpClient.Connect メソッド

定義

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

オーバーロード

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

例外

ソケットへのアクセス中にエラーが発生しました。

endPointnullです。

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

データ送信先のポート番号。

例外

UdpClient は閉じています。

addrnullです。

portMinPortMaxPort の間の値ではありません。

ソケットへのアクセス中にエラーが発生しました。

次の例では、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 リモート ホストを使用せずに別の 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(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

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

例外

UdpClient が閉じています。

portMinPortMaxPort の間の値ではありません。

ソケットへのアクセス中にエラーが発生しました。

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

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

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

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

注意

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

こちらもご覧ください

適用対象