TsgcHTTP3Client › Methoden › QueryAsync
Sendet eine nicht-blockierende HTTP/3-QUERY-Anfrage; die Antwort trifft über OnResponse ein.
procedure QueryAsync(const aURL: string; const aData: string;
const aContentType: string = 'application/x-www-form-urlencoded');| Name | Typ | Beschreibung |
|---|---|---|
aURL | const string | Absolute URL der Zielressource. |
aData | const string | Anfrage-Body. Er wird vor dem Senden als UTF-8 kodiert. |
aContentType | const string | Wert des content-type-Anfrage-Headers. Standardwert ist application/x-www-form-urlencoded. |
Keine. Die Antwort wird über OnResponse zugestellt.
Die Anfrage läuft in einem Hintergrund-Thread, und die Methode kehrt sofort zurück. Die Antwort wird über OnResponse geliefert, und ein Fehler wird über OnError gemeldet.
QUERY ist die IETF-HTTP-QUERY-Methode: eine sichere, idempotente Anfrage, die einen Body überträgt und für Such- und Filter-Payloads geeignet ist, die nicht in einen Query-String passen.
Das synchrone Gegenstück ist Query, das blockiert und den Body direkt zurückgibt.
Die Ereignisse werden im Hintergrund-Worker-Thread ausgelöst, der die Anfrage ausgeführt hat, nicht im Haupt-Thread. Synchronisieren Sie, bevor Sie aus dem Handler auf VCL- oder FMX-Steuerelemente zugreifen.
oClient.OnResponse := OnResponseEvent;
oClient.QueryAsync('https://api.example.com/v1/items', '{}');