WriteData メソッド

明示的な宛先アドレスとポートに単一の UDP データグラムを送信します。

オーバーロード

オーバーロード 1

構文

procedure WriteData(const aIPAddress: string; aPort: Word; const aValue: string);

パラメータ

名前	タイプ	説明
`aIPAddress`	`const string`	宛先の IPv4/IPv6 アドレスまたは DNS 名。この呼び出しのみ Host プロパティをオーバーライドします。
`aPort`	`Word`	この呼び出しに限り、Portプロパティをオーバーライドする、1から65535の範囲の宛先UDPポートです。
`aValue`	`const string`	テキストペイロード。送信前に UTF-8 バイトにエンコードされます。

解説

指定されたアドレスに文字列ペイロードを単一の UDP データグラムとして送信し、Host/Port プロパティは変更しません。このオーバーロードは、テキストメッセージのブロードキャスト、以前に受信したピアへの返信、または1つのクライアントインスタンスから複数のホストをターゲットにする場合に便利です。DTLS が有効な場合、データグラムは現在キャッシュされた DTLS セッションで暗号化されます。

使用例

oClient.WriteData('192.168.1.10', 5000, 'hello');

オーバーロード 2

構文

procedure WriteData(const aIPAddress: string; aPort: Word; const aValue: TBytes);

パラメータ

名前	タイプ	説明
`aIPAddress`	`const string`	宛先の IPv4/IPv6 アドレスまたは DNS 名。この呼び出しのみ Host プロパティをオーバーライドします。
`aPort`	`Word`	この呼び出しに限り、Portプロパティをオーバーライドする、1から65535の範囲の宛先UDPポートです。
`aValue`	`const TBytes`	UDP データグラム内にそのまま送信される生のバイナリペイロード。

解説

指定されたアドレスとポートに単一の UDP データグラムとしてバイナリバッファを送信します。ペイロードがテキストでない場合（例えばシリアライズされたプロトコルフレーム、音声サンプル、メディア）、文字セット変換が適用されないようにこの形式を使用します。IP フラグメンテーションを避けるため、データグラムサイズはパス MTU（通常 IPv4 イーサネットで 1472 バイト）未満に保つ必要があります。

使用例

var vBytes: TBytes;
begin
  vBytes := TEncoding.UTF8.GetBytes('ping');
  oClient.WriteData('192.168.1.10', 5000, vBytes);
end;

メソッドに戻る