UdpClient コンストラクター

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

UdpClient クラスの新しいインスタンスを初期化します。

オーバーロード

UdpClient()	UdpClient クラスの新しいインスタンスを初期化します。
UdpClient(Int32)	UdpClient クラスの新しいインスタンスを初期化し、指定したローカル ポート番号にバインドします。
UdpClient(IPEndPoint)	UdpClient クラスの新しいインスタンスを初期化し、指定したローカル エンドポイントにバインドします。
UdpClient(AddressFamily)	UdpClient クラスの新しいインスタンスを初期化します。
UdpClient(Int32, AddressFamily)	UdpClient クラスの新しいインスタンスを初期化し、指定したローカル ポート番号にバインドします。
UdpClient(String, Int32)	UdpClient クラスの新しいインスタンスを初期化し、既定のリモート ホストを確立します。

UdpClient()

ソース:

UDPClient.cs

UdpClient クラスの新しいインスタンスを初期化します。

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

例外

SocketException

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

例

次の例では、パラメーターなしのコンストラクターを使用して クラスのインスタンスを作成する方法を UdpClient 示します。

//Creates an instance of the UdpClient class using the default constructor.
UdpClient^ udpClient = gcnew UdpClient;

//Creates an instance of the UdpClient class using the default constructor.
UdpClient udpClient = new UdpClient();

'Creates an instance of the UdpClient class using the default constructor.
Dim udpClient As New UdpClient()

注釈

このコンストラクターは新 UdpClient しい を作成し、基になるサービス プロバイダーが最も適切なローカル IPv4 アドレスとポート番号を割り当てることができます。 このコンストラクターを使用する UdpClient 場合、インスタンスは IPv4 のアドレス ファミリで設定され、IPv6 ターゲットを使用した connect メソッド呼び出しで変更または上書きすることはできません。

注意

を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

このコンストラクターは、ソケット バインドを実行しないため、マルチキャスト グループへの参加には適していません。 また、IPv4 アドレスの種類でのみ機能します。

UdpClient(Int32)

ソース:

UDPClient.cs

UdpClient クラスの新しいインスタンスを初期化し、指定したローカル ポート番号にバインドします。

public:
 UdpClient(int port);

public UdpClient (int port);

new System.Net.Sockets.UdpClient : int -> System.Net.Sockets.UdpClient

Public Sub New (port As Integer)

パラメーター

port

Int32

通信を開始するローカル ポート番号。

例外

ArgumentOutOfRangeException

port パラメーターが MaxPort より大きい値か MinPort より小さい値です。

SocketException

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

例

次の例では、ローカル ポート番号を使用して クラスのインスタンスを作成する方法を UdpClient 示します。

//Creates an instance of the UdpClient class to listen on
// the default interface using a particular port.
try
{
   UdpClient^ udpClient = gcnew UdpClient( 11000 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the UdpClient class to listen on
// the default interface using a particular port.
try{
         UdpClient udpClient = new UdpClient(11000);
}
catch (Exception e ) {
          Console.WriteLine(e.ToString());
  }

'Creates an instance of the UdpClient class to listen on 
'the default interface using a particular port.
Try
   Dim udpClient As New UdpClient(11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注釈

このコンストラクターは、基になる Socket を作成し、通信元のポート番号にバインドします。 ローカル ポート番号の設定のみに関心がある場合は、このコンストラクターを使用します。 基になるサービス プロバイダーは、ローカル IP アドレスを割り当てます。 コンストラクターに 0 を渡すと、基になるサービス プロバイダーによってポート番号が割り当てられます。 このコンストラクターを使用する UdpClient 場合、インスタンスは IPv4 のアドレス ファミリで設定され、IPv6 ターゲットを使用した connect メソッド呼び出しで変更または上書きすることはできません。

注意

を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

このコンストラクターは、IPv4 アドレス型でのみ機能します。

UdpClient(IPEndPoint)

ソース:

UDPClient.cs

UdpClient クラスの新しいインスタンスを初期化し、指定したローカル エンドポイントにバインドします。

public:
 UdpClient(System::Net::IPEndPoint ^ localEP);

public UdpClient (System.Net.IPEndPoint localEP);

new System.Net.Sockets.UdpClient : System.Net.IPEndPoint -> System.Net.Sockets.UdpClient

Public Sub New (localEP As IPEndPoint)

パラメーター

localEP

IPEndPoint

UDP 接続のバインド先のローカル エンドポイントを表す IPEndPoint。

例外

ArgumentNullException

localEP が nullです。

SocketException

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

例

次の例では、ローカル エンドポイントを使用して クラスのインスタンスを UdpClient 作成する方法を示します。

//Creates an instance of the UdpClient class using a local endpoint.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );

try
{
   UdpClient^ udpClient = gcnew UdpClient( ipLocalEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the UdpClient class using a local endpoint.
 IPAddress ipAddress = Dns.Resolve(Dns.GetHostName()).AddressList[0];
 IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);

try{
     UdpClient udpClient = new UdpClient(ipLocalEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Creates an instance of the UdpClient class using a local endpoint.
Dim ipAddress As IPAddress = Dns.Resolve(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 11000)

Try
   Dim udpClient As New UdpClient(ipLocalEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注釈

このコンストラクターは、新しい UdpClient を作成し、 パラメーターでlocalEP指定された にIPEndPointバインドします。 このコンストラクターを呼び出す前に、データの送受信元となる IP アドレスとポート番号を使用して を作成 IPEndPoint する必要があります。 データの送受信にローカル IP アドレスとポート番号を指定する必要はありません。 そうでない場合、基になるサービス プロバイダーは、最も適切なローカル IP アドレスとポート番号を割り当てます。

このコンストラクターを使用する UdpClient 場合、インスタンスは、別のアドレス ファミリを持つ connect メソッド呼び出しで localEP 変更または上書きできないパラメーターで指定されたアドレス ファミリで設定されます。

注意

を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

こちらもご覧ください

• IPEndPoint

UdpClient(AddressFamily)

ソース:

UDPClient.cs

UdpClient クラスの新しいインスタンスを初期化します。

public:
 UdpClient(System::Net::Sockets::AddressFamily family);

public UdpClient (System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.UdpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.UdpClient

Public Sub New (family As AddressFamily)

パラメーター

family

AddressFamily

ソケットのアドレッシング スキームを指定する AddressFamily 値の 1 つ。

例外

ArgumentException

family が、InterNetwork でも InterNetworkV6 でもありません。

SocketException

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

注釈

パラメーターは family 、リスナーが IP バージョン 4 アドレス (IPv4) または IP バージョン 6 (IPv6) アドレスのどちらを使用するかを決定します。 IPv4 アドレスを使用するには、 値を InterNetwork 渡します。 IPv6 アドレスを使用するには、 値を InterNetworkV6 渡します。 他の値を渡すと、 メソッドは をスローします ArgumentException。

このコンストラクターを使用する UdpClient 場合、インスタンスは、別のアドレス ファミリを持つ connect メソッド呼び出しで family 変更または上書きできないパラメーターで指定されたアドレス ファミリで設定されます。

注意

を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

UdpClient.UdpClient(AddressFamily)は、ソケット バインドを実行しないため、マルチキャスト グループへの参加には適していません。

UdpClient(Int32, AddressFamily)

ソース:

UDPClient.cs

UdpClient クラスの新しいインスタンスを初期化し、指定したローカル ポート番号にバインドします。

public:
 UdpClient(int port, System::Net::Sockets::AddressFamily family);

public UdpClient (int port, System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.UdpClient : int * System.Net.Sockets.AddressFamily -> System.Net.Sockets.UdpClient

Public Sub New (port As Integer, family As AddressFamily)

パラメーター

port

Int32

受信接続の試行を待機するポート。

family

AddressFamily

ソケットのアドレッシング スキームを指定する AddressFamily 値の 1 つ。

例外

ArgumentException

family が、InterNetwork でも InterNetworkV6 でもありません。

ArgumentOutOfRangeException

port は MaxPort を超えているか、または MinPort 未満です。

SocketException

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

例

次のコード例は、マルチキャスト グループで使用する UDP クライアントを作成する方法を示しています。

// Bind and listen on port 2000. This constructor creates a socket
// and binds it to the port on which to receive data. The family
// parameter specifies that this connection uses an IPv6 address.
clientOriginator = gcnew UdpClient( 2000,AddressFamily::InterNetworkV6 );

// Join or create a multicast group. The multicast address ranges
// to use are specified in RFC#2375. You are free to use
// different addresses.
// Transform the String* address into the internal format.
m_GrpAddr = IPAddress::Parse( "FF01::1" );

// Display the multicast address used.
Console::WriteLine( "Multicast Address: [ {0}]", m_GrpAddr );

// Exercise the use of the IPv6MulticastOption.
Console::WriteLine( "Instantiate IPv6MulticastOption(IPAddress)" );

// Instantiate IPv6MulticastOption using one of the
// overloaded constructors.
IPv6MulticastOption^ ipv6MulticastOption = gcnew IPv6MulticastOption( m_GrpAddr );

// Store the IPAdress multicast options.
IPAddress^ group = ipv6MulticastOption->Group;
__int64 interfaceIndex = ipv6MulticastOption->InterfaceIndex;

// Display IPv6MulticastOption properties.
Console::WriteLine( "IPv6MulticastOption::Group: [ {0}]", group );
Console::WriteLine( "IPv6MulticastOption::InterfaceIndex: [ {0}]", interfaceIndex );

// Instantiate IPv6MulticastOption using another
// overloaded constructor.
IPv6MulticastOption^ ipv6MulticastOption2 = gcnew IPv6MulticastOption( group,interfaceIndex );

// Store the IPAdress multicast options.
group = ipv6MulticastOption2->Group;
interfaceIndex = ipv6MulticastOption2->InterfaceIndex;

// Display the IPv6MulticastOption2 properties.
Console::WriteLine( "IPv6MulticastOption::Group: [ {0} ]", group );
Console::WriteLine( "IPv6MulticastOption::InterfaceIndex: [ {0} ]", interfaceIndex );

// Join the specified multicast group using one of the
// JoinMulticastGroup overloaded methods.
clientOriginator->JoinMulticastGroup( (int)interfaceIndex, group );

// Define the endpoint data port. Note that this port number
// must match the ClientTarget UDP port number which is the
// port on which the ClientTarget is receiving data.
m_ClientTargetdest = gcnew IPEndPoint( m_GrpAddr,1000 );

// Bind and listen on port 2000. This constructor creates a socket
// and binds it to the port on which to receive data. The family
// parameter specifies that this connection uses an IPv6 address.
clientOriginator = new UdpClient(2000, AddressFamily.InterNetworkV6);

// Join or create a multicast group. The multicast address ranges
// to use are specified in RFC#2375. You are free to use
// different addresses.

// Transform the string address into the internal format.
m_GrpAddr = IPAddress.Parse("FF01::1");

// Display the multicast address used.
Console.WriteLine("Multicast Address: [" + m_GrpAddr.ToString() + "]");

// Exercise the use of the IPv6MulticastOption.
Console.WriteLine("Instantiate IPv6MulticastOption(IPAddress)");

// Instantiate IPv6MulticastOption using one of the
// overloaded constructors.
IPv6MulticastOption ipv6MulticastOption = new IPv6MulticastOption(m_GrpAddr);

// Store the IPAdress multicast options.
IPAddress group =  ipv6MulticastOption.Group;
long interfaceIndex = ipv6MulticastOption.InterfaceIndex;

// Display IPv6MulticastOption properties.
Console.WriteLine("IPv6MulticastOption.Group: [" + group  + "]");
Console.WriteLine("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex + "]");



// Instantiate IPv6MulticastOption using another
// overloaded constructor.
IPv6MulticastOption ipv6MulticastOption2 = new IPv6MulticastOption(group, interfaceIndex);

// Store the IPAdress multicast options.
group =  ipv6MulticastOption2.Group;
interfaceIndex = ipv6MulticastOption2.InterfaceIndex;

// Display the IPv6MulticastOption2 properties.
Console.WriteLine("IPv6MulticastOption.Group: [" + group  + "]");
Console.WriteLine("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex + "]");

// Join the specified multicast group using one of the
// JoinMulticastGroup overloaded methods.
clientOriginator.JoinMulticastGroup((int)interfaceIndex, group);


// Define the endpoint data port. Note that this port number
// must match the ClientTarget UDP port number which is the
// port on which the ClientTarget is receiving data.
m_ClientTargetdest = new IPEndPoint(m_GrpAddr, 1000);

' Bind and listen on port 2000. This constructor creates a socket 
' and binds it to the port on which to receive data. The family 
' parameter specifies that this connection uses an IPv6 address.
clientOriginator = New UdpClient(2000, AddressFamily.InterNetworkV6)

' Join or create a multicast group. The multicast address ranges 
' to use are specified in RFC#2375. You are free to use 
' different addresses.
' Transform the string address into the internal format.
m_GrpAddr = IPAddress.Parse("FF01::1")

' Display the multicast address used.
Console.WriteLine(("Multicast Address: [" + m_GrpAddr.ToString() + "]"))

' Exercise the use of the IPv6MulticastOption.
Console.WriteLine("Instantiate IPv6MulticastOption(IPAddress)")

' Instantiate IPv6MulticastOption using one of the 
' overloaded constructors.
Dim ipv6MulticastOption As New IPv6MulticastOption(m_GrpAddr)

' Store the IPAdress multicast options.
Dim group As IPAddress = ipv6MulticastOption.Group
Dim interfaceIndex As Long = ipv6MulticastOption.InterfaceIndex

' Display IPv6MulticastOption properties.
Console.WriteLine(("IPv6MulticastOption.Group: [" + group.ToString() + "]"))
Console.WriteLine(("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex.ToString() + "]"))

' Instantiate IPv6MulticastOption using another 
' overloaded constructor.
Dim ipv6MulticastOption2 As New IPv6MulticastOption(group, interfaceIndex)

' Store the IPAdress multicast options.
group = ipv6MulticastOption2.Group
interfaceIndex = ipv6MulticastOption2.InterfaceIndex

' Display the IPv6MulticastOption2 properties.
Console.WriteLine(("IPv6MulticastOption.Group: [" + group.ToString() + "]"))
Console.WriteLine(("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex.ToString() + "]"))

' Join the specified multicast group using one of the 
' JoinMulticastGroup overloaded methods.
clientOriginator.JoinMulticastGroup(Fix(interfaceIndex), group)

' Define the endpoint data port. Note that this port number
' must match the ClientTarget UDP port number which is the
' port on which the ClientTarget is receiving data.
m_ClientTargetdest = New IPEndPoint(m_GrpAddr, 1000)

注釈

このコンストラクターは、基になる Socket を作成し、通信元のポート番号にバインドします。

パラメーターは family 、リスナーが IP バージョン 4 アドレス (IPv4) または IP バージョン 6 (IPv6) アドレスのどちらを使用するかを決定します。 IPv4 アドレスを使用するには、 値を InterNetwork 渡します。 IPv6 アドレスを使用するには、 値を InterNetworkV6 渡します。 他の値を渡すと、 メソッドは をスローします ArgumentException。

このコンストラクターを使用する UdpClient 場合、インスタンスは、別のアドレス ファミリを持つ connect メソッド呼び出しで family 変更または上書きできないパラメーターで指定されたアドレス ファミリで設定されます。

注意

を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

UdpClient(String, Int32)

ソース:

UDPClient.cs

UdpClient クラスの新しいインスタンスを初期化し、既定のリモート ホストを確立します。

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

public UdpClient (string hostname, int port);

new System.Net.Sockets.UdpClient : string * int -> System.Net.Sockets.UdpClient

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

パラメーター

hostname

String

接続先のリモート DNS ホスト名。

port

Int32

接続先のリモート ポート番号。

例外

ArgumentNullException

hostname が nullです。

ArgumentOutOfRangeException

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

SocketException

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

例

次の例では、ホスト名とポート番号を使用して クラスの UdpClient インスタンスを作成する方法を示します。

//Creates an instance of the UdpClient class with a remote host name and a port number.
try
{
   UdpClient^ udpClient = gcnew UdpClient( "www.contoso.com",11000 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the UdpClient class with a remote host name and a port number.
try{
     UdpClient udpClient = new UdpClient("www.contoso.com",11000);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Creates an instance of the UdpClient class with a remote host name and a port number.
Try
   Dim udpClient As New UdpClient("www.contoso.com", 11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注釈

このコンストラクターは、新しい UdpClient を初期化し、 パラメーターと port パラメーターを使用してリモート ホストをhostname確立します。 既定のリモート ホストの確立は省略可能です。 このコンストラクターを使用する場合は、 メソッドの各呼び出しでリモート ホストを指定する Send 必要はありません。 既定のリモート ホストを指定すると、そのホストのみに制限されます。 既定のリモート ホストは、 メソッドを呼び出 Connect すことでいつでも変更できます。 メソッドの呼び出しでリモート ホストを指定する Send 場合は、このコンストラクターを使用しないでください。

注意

を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

こちらもご覧ください

• Send(Byte[], Int32, IPEndPoint)
• Connect(String, Int32)