語言

DatagramSocketMessageReceivedEventArgs 類別

定義

命名空間:
Windows.Networking.Sockets
編輯

提供資料報套接字上的 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 需求

規格需求 Description
裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

DatagramSocketMessageReceivedEventArgs 用於接收 DatagramSocket 物件的資料。

如果 DatagramSocket 實例想要監聽並接收資料，則使用 DatagramSocket.BindServiceNameAsync 或 DatagramSocket.BindEndpointAsync 方法，將 DatagramSocket 綁定到本地服務名稱或 UDP 埠口。 如果 DatagramSocket 僅用於傳送資料，這些方法就不需要了。

當收到訊息時， DatagramSocket.MessageReceived 事件會發生在綁定到本地服務名稱或 UDP 埠的 DatagramSocket 上。 當 DatagramSocket.MessageReceivedReceived 事件發生時，會建立一個 DatagramSocketSocketReceivedEventArgs 實例。

當收到訊息時，讀取資料有兩種主要方法：

  • GetDataStream 方法回傳一個 Streams.IInputStream 物件，代表接收訊息中的連續位元組串流。 應用程式接著必須解析接收到的位元組串流。
  • GetDataReader 方法會回傳一個 Streams.DataReader 物件來讀取輸入資料。 Streams.DataReader 物件擁有多種格式的讀取方法，包括位元組、有號與無號整數、布林值、單浮點數與雙浮點數、字串、日期、時間與時間範圍值、GUID 以及緩衝區。 這些方法可直接用於解析接收到的訊息。

屬性

名稱 Description
LocalAddress

當收到訊息時，會取得與 DatagramSocket 相關的本地 IP 位址。
RemoteAddress

當收到訊息時，會取得資料 報 遠端發送者的 IP 位址。
RemotePort

取得 DatagramSocket 上資料報遠端發送者的 UDP 埠號。

方法

名稱 Description
GetDataReader()

取得 一個 DataReader 物件，讀取來自遠端網路目的地的 DatagramSocket 物件接收的入資料。
GetDataStream()

會取得 一個 IInputStream 物件，代表一個連續的位元組串流，從遠端網路目的地讀取為訊息，透過 DatagramSocket 物件。

適用於

另請參閱