System.Net.HttpClientComponent.TNetHTTPRequest.Options

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function Options(const AURL: string; const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IHTTPResponse;

C++

System::Net::Httpclient::_di_IHTTPResponse __fastcall Options(const System::UnicodeString AURL, System::Classes::TStream* const AResponseContent = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>());

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Net.HTTPClientComponent.pas
System.Net.HTTPClientComponent.hpp
System.Net.HttpClientComponent TNetHTTPRequest


Beschreibung

Sendet mit der HTTP-Anforderungsmethode OPTIONS eine HTTP-Anforderung an den angegebenen URL, wartet auf die Antwort vom Server und gibt die HTTP-Antwort des Servers zurück.

Wenn Sie die Antwortdaten erhalten möchten, während Ihr HTTP-Client sie vom Zielserver herunterlädt, anstatt zu warten, bis Ihr HTTP-Client die gesamten Daten heruntergeladen hat, geben Sie mit dem Parameter AResponseContent einen Stream an, in den die heruntergeladenen Daten aufgenommen werden sollen. Alternativ können Sie auch warten, bis Ihr HTTP-Client die gesamten Antwortdaten heruntergeladen hat, und die Antwortdaten als Stream aus der Eigenschaft ContentStream des Antwortobjekts abrufen, das Options zurückgibt.

Unabhängig davon, wie Sie die Daten erhalten, können Sie mit dem Ereignis OnReceiveData den Fortschritt des Herunterladens der Antwortdaten verfolgen.

Mit AHeaders können Sie benutzerdefinierte HTTP-Anforderungs-Header in Ihre HTTP-Anforderung einbeziehen.

Options löst eine ENetHTTPRequestException aus, wenn die HTTP-Anforderung die maximale Anzahl an Umleitungen des HTTP-Clients Ihrer Anforderung erreicht.

Siehe auch