System.Net.HttpClient.THTTPClient.Put

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function Put(const AURL: string; const ASourceFile: string; const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;
function Put(const AURL: string; const ASource: TStrings; const AResponseContent: TStream = nil;
const AEncoding: TEncoding = nil; const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;
function Put(const AURL: string; const ASource: TStream = nil; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;
function Put(const AURL: string; const ASource: TMultipartFormData; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;

C++

_di_IHTTPResponse __fastcall Put(const System::UnicodeString AURL, const System::UnicodeString ASourceFile, System::Classes::TStream* const AResponseContent = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>())/* overload */;
_di_IHTTPResponse __fastcall Put(const System::UnicodeString AURL, System::Classes::TStrings* const ASource, System::Classes::TStream* const AResponseContent = (System::Classes::TStream*)(0x0), System::Sysutils::TEncoding* const AEncoding = (System::Sysutils::TEncoding*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>())/* overload */;
_di_IHTTPResponse __fastcall Put(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>())/* overload */;
_di_IHTTPResponse __fastcall Put(const System::UnicodeString AURL, System::Net::Mime::TMultipartFormData* const ASource, System::Classes::TStream* const AResponseContent = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>())/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Net.HttpClient.pas
System.Net.HTTPClient.hpp
System.Net.HttpClient THTTPClient


Beschreibung

Sendet mit den angegebenen Daten (ASource) und der HTTP-Anforderungsmethode PUT 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.

Put löst eine ENetHTTPRequestException aus, wenn die HTTP-Anforderung die maximale Anzahl an Umleitungen erreicht.

Siehe auch