DatagramSocket.BindEndpointAsync(HostName, String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicia una operación de enlace en un DatagramSocket en un nombre de host local y un nombre de servicio local.
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 IAsyncActionParámetros
- localHostName
- HostName
Nombre de host local o dirección IP en la que se va a enlazar el objeto DatagramSocket .
- localServiceName
-
String
Platform::String
winrt::hstring
Nombre del servicio local o puerto UDP en el que se va a enlazar el objeto DatagramSocket .
Devoluciones
Una operación de enlace asincrónica en un objeto DatagramSocket .
- Atributos
Requisitos de Windows
| Características de aplicaciones |
ID_CAP_NETWORKING [Windows Phone]
internetClientServer
privateNetworkClientServer
|
Comentarios
El método BindEndpointAsync enlaza datagramSocket con el nombre de host local o la dirección IP especificada en el parámetro localHostName y el nombre del servicio local o la dirección de número de puerto UDP especificada en el parámetro localServiceName . Si el parámetro localHostName es null, el sistema seleccionará la dirección IP local en la que se va a enlazar. Si el parámetro localServiceName es una cadena vacía, el sistema seleccionará el puerto UDP local en el que se va a enlazar.
A menos que haya usado la propiedad DatagramSocketControl.MulticastOnly , se producirá un error en el método BindEndpointAsync si otra aplicación que usa UDP (por ejemplo, otro DatagramSocket) ya está enlazada a la dirección IP local y al puerto UDP especificado en los parámetros localHostName y localServiceName .
El enlace es esencial para recibir datos de cualquier punto de conexión remoto en un DatagramSocket, y normalmente se realiza después de crear un socket y se ha establecido el evento MessageReceived . El método BindServiceNameAsync o BindEndpointAsync se usa para enlazar un DatagramSocket a un nombre de servicio local o un puerto UDP. Los métodos ConnectAsync también darán lugar a una operación de enlace si el socket aún no está enlazado. Escribir en una secuencia devuelta por uno de los métodos GetOutputStreamAsync también dará como resultado una operación de enlace.
Los métodos BindServiceNameAsync y BindEndpointAsync no son necesarios en los casos siguientes:
- DatagramSocket solo se usa para enviar datos.
- DatagramSocket se usa para enviar y recibir datos de un único punto de conexión.