共用方式為


DatagramSocket.BindEndpointAsync(HostName, String) 方法

定義

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 埠。

傳回

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

屬性

Windows 需求

應用程式功能
ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

備註

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

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

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

在下列情況下,不需要 BindServiceNameAsync 和 BindEndpointAsync 方法:

適用於

另請參閱