DatagramSocket.BindEndpointAsync(HostName, String) 方法

定義

命名空間:

Windows.Networking.Sockets

在 DatagramSocket 上啟動系結作業至本機主機名稱和本機服務名稱。

public:
 virtual IAsyncAction ^ BindEndpointAsync(HostName ^ localHostName, Platform::String ^ localServiceName) = BindEndpointAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction BindEndpointAsync(HostName const& localHostName, winrt::hstring const& localServiceName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction BindEndpointAsync(HostName localHostName, string localServiceName);

function bindEndpointAsync(localHostName, localServiceName)

Public Function BindEndpointAsync (localHostName As HostName, localServiceName As String) As IAsyncAction

參數

localHostName

HostName

要系結 DatagramSocket 物件的本機主機名稱或 IP 位址。

localServiceName

String

Platform::String

winrt::hstring

要系結 DatagramSocket 物件的本機服務名稱或 UDP 埠。

傳回

IAsyncAction

DatagramSocket物件的非同步系結作業。

屬性

RemoteAsyncAttribute

Windows 需求

應用程式功能

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

備註

BindEndpointAsync 方法會將 DatagramSocket 系結至 localHostName 參數中指定的本機主機名稱或 IP 位址，以及 localServiceName 參數中指定的本機服務名稱或 UDP 埠號碼位址。 如果 localHostName 參數為 null，系統會選取要系結的本機 IP 位址。 如果 localServiceName 參數是空字串，系統會選取要系結的本機 UDP 埠。

除非您已使用DatagramSocketControl.MulticastOnly屬性，否則如果另一個使用 UDP (的應用程式使用 UDP (，其他DatagramSocket) 已經系結至localHostName和localServiceName參數中指定的本機 IP 位址和 UDP 埠，則BindEndpointAsync方法將會失敗。

系結對於從 DatagramSocket上的任何遠端端點接收資料很重要，而且通常會在建立通訊端並設定 MessageReceived 事件之後完成。 BindServiceNameAsync或 BindEndpointAsync 方法可用來將DatagramSocket系結至本機服務名稱或 UDP 埠。 如果通訊端尚未系結， ConnectAsync 方法也會產生系結作業。 寫入其中一個 GetOutputStreamAsync 方法所傳回的資料流程也會導致系結作業。

在下列情況下，不需要 BindServiceNameAsync 和 BindEndpointAsync 方法：

• DatagramSocket僅用於傳送資料。
• DatagramSocket可用來將資料傳送至單一端點，並從中接收資料。

另請參閱

• BindServiceNameAsync(String, NetworkAdapter)
• DatagramSocketInformation
• MessageReceived