TsgcHTTP2ClientMethods › Delete

Delete Methode

Führt einen synchronen HTTP/2-DELETE durch, um die durch die URL identifizierte Ressource zu entfernen.

Überladungen

Overload 1

Syntax

function Delete(const aURL: string): string;

Parameter

NameTypBeschreibung
aURLconst stringAbsolute URL der auf dem Server zu löschenden Ressource.

Rückgabewert

Antworttext (oft ein JSON-Statusdokument), als String decodiert. (string)

Hinweise

DELETE-Anfragen führen normalerweise keinen Body. Ein erfolgreicher Aufruf gibt in der Regel 204 No Content mit einer leeren Zeichenfolge zurück oder 200 OK mit einem Bestätigungsdokument, je nach Server.

Beispiel

vResponse := oClient.Delete('https://api.example.com/users/42');

Überladung 2

Syntax

procedure Delete(Const aURL: string; const aResponseContent: TStream);

Parameter

NameTypBeschreibung
aURLconst stringAbsolute URL der auf dem Server zu löschenden Ressource.
aResponseContentconst TStreamStream, der den Antwort-Body des Servers wortwörtlich sammelt.

Hinweise

Stream-basierte Variante, die die Antwort in einen vom Aufrufer bereitgestellten TStream erfasst. Wählen Sie diese Überladung, wenn die Löschantwort groß sein kann oder direkt auf die Festplatte persistiert werden muss.

Beispiel

oOut := TMemoryStream.Create;
try
  oClient.Delete('https://api.example.com/users/42', oOut);
finally
  oOut.Free;
end;

Zurück zu Methoden