MessageReceived | messagereceived event

DatagramSocket.MessageReceived | messagereceived event

An event that indicates that a message was received on the DatagramSocket object.

Syntax


function onMessageReceived(eventArgs) { /* Your code */ }
 
// addEventListener syntax
datagramSocket.addEventListener("messagereceived", onMessageReceived);
datagramSocket.removeEventListener("messagereceived", onMessageReceived);
 
- or -

datagramSocket.onmessagereceived = onMessageReceived;


Event information

Delegate TypedEventHandler<DatagramSocket, DatagramSocketMessageReceivedEventArgs>

Remarks

To receive data on the DatagramSocket object, an app must assign the MessageReceived event to an event handler and then call either the BindEndpointAsync or BindServiceNameAsync method to bind the DatagramSocket to a local service name or UDP port. The ConnectAsync methods will also result in a bind operation. Writing to a stream returned by one of the GetOutputStreamAsync methods will also result in a bind operation. The MessageReceived event handler will be invoked whenever a message from a remote endpoint arrives.

To receive multicast packets on the DatagramSocket object, an app must assign the MessageReceived event to an event handler and then call the JoinMulticastGroup method to join the multicast group.

To unregister the MessageReceived event, the DatagramSocket object must be closed. The Close method is used by Windows apps using JavaScript. For apps written using the .NET Framework 4.5 in C# and VB.NET, the Close method is exposed as the Dispose() method on the DatagramSocket. For apps written in C++, the Close method will be called when using the delete keyword on the object.

Requirements (Windows 10 device family)

Device family

Universal, introduced version 10.0.10240.0

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.Networking.Sockets
Windows::Networking::Sockets [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Capabilities

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8

Namespace

Windows.Networking.Sockets
Windows::Networking::Sockets [C++]

Metadata

Windows.winmd

Capabilities

ID_CAP_NETWORKING [Windows Phone]

See also

DatagramSocket
DatagramSocket sample (Windows 10)

 

 

Show:
© 2016 Microsoft