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 イベントが発生したときに作成されます。

メッセージを受信したときにデータを読み取る主な方法は 2 つあります。

  • GetDataStream メソッドは、受信したメッセージ内のバイトのシーケンシャル ストリームを表す Streams.IInputStream オブジェクトを返します。 その後、アプリは受信したバイト ストリームを解析する必要があります。
  • GetDataReader メソッドは、受信データを読み取るために Streams.DataReader オブジェクトを返します。 Streams.DataReader オブジェクトには、バイト、符号付き整数、符号なし整数、符号なし整数、ブール値、単一浮動小数点数と二重浮動小数点数、文字列、日付時刻と期間の値、GUID、バッファーなど、さまざまな形式でデータを読み取る個別のメソッドがあります。 これらのメソッドを直接使用して、受信したメッセージを解析できます。

プロパティ

LocalAddress

メッセージの受信時に DatagramSocket に関連付けられているローカル IP アドレスを取得します。
RemoteAddress

メッセージの受信時に DatagramSocket 上のデータグラムのリモート送信者の IP アドレスを取得します。
RemotePort

DatagramSocket で受信したデータグラムのリモート送信者の UDP ポート番号を取得します。

メソッド

GetDataReader()

DatagramSocket オブジェクトのリモート ネットワーク宛先から受信した受信データを読み取る DataReader オブジェクトを取得します。
GetDataStream()

DatagramSocket オブジェクトのリモート ネットワーク宛先からメッセージとして読み取られる順次バイト ストリームを表す IInputStream オブジェクトを取得します。

適用対象

こちらもご覧ください