DatagramSocketMessageReceivedEventArgs 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为 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
- 继承
- 属性
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 对象上的远程网络目标读取的连续字节流。 |