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 上。 DatagramSocketMessageReceivedEventArgs 實例會在 DatagramSocket.MessageReceived 事件發生時建立。

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

  • GetDataStream方法會傳回Streams.IInputStream物件，代表所接收訊息中位元組的循序資料流程。 然後，應用程式必須剖析接收的位元組資料流程。
  • GetDataReader方法會傳回Streams.DataReader物件來讀取傳入的資料。 Streams.DataReader物件具有不同的方法來讀取各種格式的資料，包括位元組、帶正負號和不帶正負號的整數、布林值、單一和雙浮點數、字串、日期時間和時間範圍值、GUID 和緩衝區。 這些方法可以直接用來剖析收到的訊息。

屬性

LocalAddress

取得收到訊息時，與 DatagramSocket 相關聯的本機 IP 位址。
RemoteAddress

取得收到訊息時 ，DatagramSocket 上資料 報遠端寄件者的 IP 位址。
RemotePort

取得 DatagramSocket上所接收之資料包遠端傳送者的 UDP 埠號碼。

方法

GetDataReader()

會取得 DataReader 物件，以讀取從 DatagramSocket 物件上從遠端網路目的地接收的傳入資料。
GetDataStream()

取得 IInputStream 物件，表示要從 DatagramSocket 物件上從遠端網路目的地讀取為訊息的循序位元組資料流程。

適用於

另請參閱