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 DatagramSocketMessageReceivedEventArgsPublic 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 で発生します。 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 オブジェクトを取得します。 |