UdpClient コンストラクター

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

例外

例

次の例では、パラメーターなしのコンストラクターを使用して クラスのインスタンスを作成する方法を 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 メソッド呼び出しで変更または上書きすることはできません。

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

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

public:
 UdpClient(int port);

public UdpClient (int port);

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

Public Sub New (port As Integer)

パラメーター

例外

例

次の例では、ローカル ポート番号を使用して クラスのインスタンスを作成する方法を 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 メソッド呼び出しで変更または上書きすることはできません。

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

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

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)

パラメーター

例外

例

次の例では、ローカル エンドポイントを使用して クラスのインスタンスを 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 変更または上書きできないパラメーターで指定されたアドレス ファミリで設定されます。

こちらもご覧ください

• IPEndPoint

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

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

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

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

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

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)

パラメーター

例外

例

次のコード例は、マルチキャスト グループで使用する 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 変更または上書きできないパラメーターで指定されたアドレス ファミリで設定されます。

ソース:

UDPClient.cs

ソース:

UDPClient.cs

ソース:

UDPClient.cs

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)

パラメーター

例外

例

次の例では、ホスト名とポート番号を使用して クラスの 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 場合は、このコンストラクターを使用しないでください。

こちらもご覧ください

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