System.Net.HttpClientComponent.TNetHTTPRequest.Patch
Delphi
function Patch(const AURL: string; const ASource: TStream = nil; const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IHTTPResponse;
C++
System::Net::Httpclient::_di_IHTTPResponse __fastcall Patch(const System::UnicodeString AURL, System::Classes::TStream* const ASource = (System::Classes::TStream*)(0x0), 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 den angegebenen Daten (ASource
) und der HTTP-Anforderungsmethode PATCH
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.
Wenn Ihre HTTP-Anforderung über einen Proxy-HTTP-Server ausgeführt wird, der die HTTP-Anforderungsmethode PATCH
möglicherweise nicht unterstützt, verwenden Sie stattdessen PatchAlternative, um die PATCH
-Anforderungsmethode als PUT
zu tarnen.
Patch löst eine ENetHTTPRequestException aus, wenn die HTTP-Anforderung die maximale Anzahl an Umleitungen des HTTP-Clients Ihrer Anforderung erreicht.
Siehe auch
- System.Net.HttpClientComponent.TNetHTTPRequest.Delete
- System.Net.HttpClientComponent.TNetHTTPRequest.Get
- System.Net.HttpClientComponent.TNetHTTPRequest.Head
- System.Net.HttpClientComponent.TNetHTTPRequest.Merge
- System.Net.HttpClientComponent.TNetHTTPRequest.Options
- System.Net.HttpClientComponent.TNetHTTPRequest.Post
- System.Net.HttpClientComponent.TNetHTTPRequest.Put
- System.Net.HttpClientComponent.TNetHTTPRequest.Trace