TsgcHTTP3Client › Eigenschaften › MaxResponseSize

MaxResponseSize Eigenschaft

Maximale Anzahl der pro Anfrage akzeptierten Bytes des Antwort-Bodys, oder 0 für kein Limit.

Syntax

property MaxResponseSize: Int64 read FMaxResponseSize write FMaxResponseSize;

Typ

Int64

Hinweise

0 (unbegrenzt)

Hinweise

MaxResponseSize begrenzt die Gesamtzahl der Body-Bytes, die der Client für eine einzelne Anfrage ansammelt. Wenn eine Antwort über das Limit hinauswächst, wird die Anfrage beendet und eine Ausnahme ausgelöst, die bei einem synchronen Aufruf über OnHTTP3Exception und bei einem asynchronen über OnError zutage tritt.

Der Standardwert 0 bedeutet unbegrenzt. Setzen Sie ein Limit, wenn Sie mit Servern kommunizieren, die Sie nicht kontrollieren, damit ein feindlicher oder fehlerhafter Peer den Speicher nicht erschöpfen kann, indem er einen unbegrenzten Body in den Client streamt.

Das Limit zählt nur Body-Bytes und gilt pro Anfrage, nicht pro Verbindung. Um etwas berechtigterweise Großes herunterzuladen, ohne es im Speicher zu puffern, verwenden Sie die Stream-Überladung des Verbs, zum Beispiel Get mit einem TFileStream.

Dieser Client folgt Weiterleitungen nicht automatisch, daher gelten die Optionen zum Entfernen von Anmeldeinformationen über Host-Grenzen hinweg und zum unsicheren Downgrade, die andere HTTP-Clients bieten, hier nicht: Ein 3xx-Status wird zur Behandlung an den Aufrufer zurückgegeben.

Dieses Mitglied ist derzeit nur in der Delphi/C++Builder-Implementierung verfügbar.

Beispiel



// refuse any response body larger than 10 MB

oClient.MaxResponseSize := 10 * 1024 * 1024;

Zurück zu Properties