UdpClient 建構函式

來源:

UDPClient.cs

來源:

UDPClient.cs

來源:

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 = 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

來源:

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 = 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

來源:

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 = 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置，並將其綁定到參數指定的IPEndPoint條件localEP下。 在呼叫這個建構器之前，你必須先建立 IPEndPoint 一個使用 IP 位址和埠號，並用來傳送和接收資料。 你不需要指定本地 IP 位址和埠號來傳送和接收資料。 如果沒有，底層服務提供商會分配最合適的本地 IP 位址和埠號。

若使用此建構子， UdpClient 實例會以參數指定的 localEP 地址族設定，該族無法被不同位址族的 connect 方法呼叫更改或覆寫。

另請參閱

• IPEndPoint

來源:

UDPClient.cs

來源:

UDPClient.cs

來源:

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 實例會以參數指定的 family 地址族設定，該族無法被不同位址族的 connect 方法呼叫更改或覆寫。

不 UdpClient.UdpClient(AddressFamily) 適合加入多播群組，因為它不執行套接字綁定。

來源:

UDPClient.cs

來源:

UDPClient.cs

來源:

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 = 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 實例會以參數指定的 family 地址族設定，該族無法被不同位址族的 connect 方法呼叫更改或覆寫。

來源:

UDPClient.cs

來源:

UDPClient.cs

來源:

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 = 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 主機，並使用 hostname and port 參數建立遠端主機。 建立預設遠端主機是可選的。 如果你使用這個建構子，就不必在每次呼叫 Send 方法時指定遠端主機。 指定預設遠端主機會限制你只能使用該主機。 你可以隨時透過呼叫 Connect 方法來更改預設的遠端主機。 如果你想在呼叫 Send 方法時指定遠端主機，請不要使用這個建構子。

另請參閱

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