DatagramSocketMessageReceivedEventArgs 类

  • 参考

定义

命名空间:
Windows.Networking.Sockets
编辑

为 DatagramSocket 上的 MessageReceived 事件提供数据。

public ref class DatagramSocketMessageReceivedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.GCPressure]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DatagramSocketMessageReceivedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.GCPressure]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DatagramSocketMessageReceivedEventArgs
Public NotInheritable Class DatagramSocketMessageReceivedEventArgs
继承
Object Platform::Object IInspectable DatagramSocketMessageReceivedEventArgs
属性
ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
应用功能
ID_CAP_NETWORKING [Windows Phone]

注解

DatagramSocketMessageReceivedEventArgs 用于接收 DatagramSocket 对象上的数据。

DatagramSocket 实例想要侦听和接收数据时，DatagramSocket.BindServiceNameAsync 或 DatagramSocket.BindEndpointAsync 方法用于将 DatagramSocket 绑定到本地服务名称或 UDP 端口。 如果 DatagramSocket 仅用于发送数据，则不需要这些方法。

收到消息时， DatagramSocket.MessageReceived 事件发生在已绑定到本地服务名称或 UDP 端口的 DatagramSocket 上。 发生 DatagramSocket.MessageReceived 事件时，将创建 DatagramSocketMessageReceivedEventArgs 实例。

收到消息时，有两种主要方法来读取数据：

  • GetDataStream 方法返回一个 Streams.IInputStream 对象，该对象表示接收的消息中的字节顺序流。 然后，应用必须分析收到的字节流。
  • GetDataReader 方法返回 Streams.DataReader 对象以读取传入数据。 Streams.DataReader 对象具有单独的方法来读取各种格式的数据，包括字节、有符号和无符号整数、布尔值、单和双浮点数、字符串、日期时间和时间跨度值、GUID 以及缓冲区。 这些方法可以直接用于分析收到的消息。

属性

LocalAddress

获取在收到消息时与 DatagramSocket 关联的本地 IP 地址。
RemoteAddress

在收到消息时，获取 DatagramSocket 上数据报 的远程发送方的 IP 地址。
RemotePort

获取在 DatagramSocket 上接收的数据报的远程发送方的 UDP 端口号。

方法

GetDataReader()

获取 DataReader 对象，用于读取从 DatagramSocket 对象上的远程网络目标接收的传入数据。
GetDataStream()

获取 一个 IInputStream 对象，该对象表示要作为消息从 DatagramSocket 对象上的远程网络目标读取的连续字节流。

适用于

另请参阅