TsgcUDPCLient › Methoden › WriteData

WriteData Methode

Verzendt een enkel UDP-datagram naar een expliciet bestemmingsadres en poort.

Overloads

Overload 1

Syntaxis

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

Parameters

NaamTypeBeschrijving
aIPAddressconst stringDoel-IPv4/IPv6-adres of DNS-naam. Overschrijft de Host-eigenschap alleen voor deze aanroep.
aPortWordDoel-UDP-poort in het bereik 1 tot 65535. Overschrijft de eigenschap Port alleen voor deze aanroep.
aValueconst stringTekstpayload. Gecodeerd als UTF-8-bytes voordat deze wordt verzonden.

Opmerkingen

Verzendt de tekenreeks-payload als een enkel UDP-datagram naar het opgegeven adres, zonder de Host/Port-eigenschappen te wijzigen. Deze overload is handig voor het uitzenden van tekstberichten, het beantwoorden van een eerder ontvangen peer of het richten op meerdere hosts vanuit één clientinstantie. Wanneer DTLS is ingeschakeld, wordt het datagram versleuteld met de huidige DTLS-sessie in de cache.

Voorbeeld

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

Overload 2

Syntaxis

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

Parameters

NaamTypeBeschrijving
aIPAddressconst stringDoel-IPv4/IPv6-adres of DNS-naam. Overschrijft de Host-eigenschap alleen voor deze aanroep.
aPortWordDoel-UDP-poort in het bereik 1 tot 65535. Overschrijft de eigenschap Port alleen voor deze aanroep.
aValueconst TBytesRaw binary payload sent verbatim inside the UDP datagram.

Opmerkingen

Verzendt een binaire buffer als één UDP-datagram naar het opgegeven adres en de opgegeven poort. Gebruik dit formulier wanneer de payload geen tekst is (bijvoorbeeld geserialiseerde protocolframes, audiosamples of media) zodat er geen tekensetconversie wordt toegepast. De datagramgrootte moet onder de padmtu worden gehouden (doorgaans 1472 bytes op IPv4 Ethernet) om IP-fragmentatie te voorkomen.

Voorbeeld

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

Terug naar methoden