TsgcHTTP3Client › Methoden › RequestOptions

RequestOptions Methode

Sendet eine synchrone HTTP/3-OPTIONS-Anfrage, um die Kommunikationsoptionen einer Ressource abzufragen.

Syntax

RequestOptions(const aURL: string): string String-Überladung

function RequestOptions(const aURL: string): string; overload;

Name	Typ	Beschreibung
`aURL`	`const string`	Absolute URL der Zielressource.

Vom Server empfangener Antworttext, als String dekodiert. (string)

RequestOptions(const aURL: string; const aResponseContent: TStream) Stream-Überladung

procedure RequestOptions(const aURL: string;

  const aResponseContent: TStream); overload;

Name	Typ	Beschreibung
`aURL`	`const string`	Absolute URL der Zielressource.
`aResponseContent`	`TStream`	Stream, der den Antwort-Body empfängt.

Keine. Der Antwort-Body wird nach aResponseContent geschrieben.

Hinweise

Der Aufruf blockiert den aufrufenden Thread, bis die vollständige Antwort empfangen wurde. Wenn der Client noch nicht verbunden ist, wird die URL verwendet, um zuerst die QUIC-Verbindung zu öffnen. Für eine nicht-blockierende Anfrage verwenden Sie OptionsAsync, das die Antwort über OnResponse liefert.

OPTIONS fragt den Server, welche Methoden und Fähigkeiten die Zielressource unterstützt. Die Antwort wird normalerweise im Antwort-Header allow übermittelt, zusammen mit den CORS-Headern access-control-allow-*, wenn die Anfrage ein Preflight ist.

Die Methode heißt RequestOptions und nicht Options, weil Options mit einem vorhandenen Bezeichner in Delphi und C++Builder kollidiert. Das asynchrone Gegenstück behält den Protokollnamen und heißt OptionsAsync.

Beispiel



vResponse := oClient.RequestOptions('https://api.example.com/v1/users');

Zurück zu Methoden