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
Локальное имя узла или IP-адрес, по которому необходимо привязать объект DatagramSocket .
- localServiceName
-
String
Platform::String
winrt::hstring
Имя локальной службы или UDP-порт, к которому необходимо привязать объект DatagramSocket .
Возвращаемое значение
Асинхронная операция привязки для объекта DatagramSocket .
- Атрибуты
Требования к Windows
| Возможности приложения |
ID_CAP_NETWORKING [Windows Phone]
internetClientServer
privateNetworkClientServer
|
Комментарии
Метод BindEndpointAsync привязывает DatagramSocket к локальному имени узла или IP-адресу, указанному в параметре localHostName , и имени локальной службы или адресу номера порта UDP, указанному в параметре localServiceName . Если параметр localHostName имеет значение NULL, система выберет локальный IP-адрес для привязки. Если параметр localServiceName является пустой строкой, система выберет локальный UDP-порт, к которому требуется выполнить привязку.
Если вы не использовали свойство DatagramSocketControl.MulticastOnly , метод BindEndpointAsync завершится ошибкой, если другое приложение, использующее UDP (например, другое datagramSocket), уже привязано к локальному IP-адресу и порту UDP, указанным в параметрах localHostName и localServiceName .
Привязка необходима для получения данных из любой удаленной конечной точки в DatagramSocket и обычно выполняется после создания сокета и установки события MessageReceived . Метод BindServiceNameAsync или BindEndpointAsync используется для привязки DatagramSocket к имени локальной службы или порту UDP. Методы ConnectAsync также приводят к операции привязки, если сокет еще не привязан. Запись в поток, возвращаемый одним из методов GetOutputStreamAsync , также приведет к операции привязки.
Методы BindServiceNameAsync и BindEndpointAsync не требуются в следующих случаях:
- DatagramSocket используется только для отправки данных.
- DatagramSocket используется для отправки данных в одну конечную точку и получения данных из нее.