TsgcHTTP3Client › Methoden › PostAsync
Sendet eine nicht-blockierende HTTP/3-POST-Anfrage; die Antwort trifft über OnResponse ein.
procedure PostAsync(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.
POST übermittelt Daten an die Zielressource, typischerweise um einen Datensatz zu erstellen oder eine serverseitige Aktion aufzurufen.
Das synchrone Gegenstück ist Post, 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.PostAsync('https://api.example.com/v1/items', '{}');