System.Net.HttpClientComponent.TNetHTTPRequest.Get

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

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

C++

System::Net::Httpclient::_di_IHTTPResponse __fastcall Get(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 GET 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 Get 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.

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

Siehe auch