DatagramSocket.BindEndpointAsync(HostName, String) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在 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) 已經系結至localHostName和localServiceName參數中指定的本機 IP 位址和 UDP 埠，則BindEndpointAsync方法將會失敗。
系結對於從 DatagramSocket上的任何遠端端點接收資料很重要，而且通常會在建立通訊端並設定 MessageReceived 事件之後完成。 BindServiceNameAsync或 BindEndpointAsync 方法可用來將DatagramSocket系結至本機服務名稱或 UDP 埠。 如果通訊端尚未系結， ConnectAsync 方法也會產生系結作業。 寫入其中一個 GetOutputStreamAsync 方法所傳回的資料流程也會導致系結作業。
在下列情況下，不需要 BindServiceNameAsync 和 BindEndpointAsync 方法：
- DatagramSocket僅用於傳送資料。
- DatagramSocket可用來將資料傳送至單一端點，並從中接收資料。