Skip to main content
DatagramSocket.MessageReceived | messagereceived event

Applies to Windows and Windows Phone

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;

public event TypedEventHandler<DatagramSocket, DatagramSocketMessageReceivedEventArgs> MessageReceived

Public Event MessageReceived As TypedEventHandler(Of DatagramSocket, DatagramSocketMessageReceivedEventArgs)

public:
event TypedEventHandler<DatagramSocket, DatagramSocketMessageReceivedEventArgs>^ MessageReceived {
   Windows::Foundation::EventRegistrationToken add(TypedEventHandler<DatagramSocket, DatagramSocketMessageReceivedEventArgs>^ value);
   void remove(Windows::Foundation::EventRegistrationToken token);
}

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 Store 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

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

DLL

Windows.Networking.dll

Capabilities

ID_CAP_NETWORKING [Windows Phone]

See also

DatagramSocket