System.Net.HttpClient.THTTPClient.Post

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

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

C++

_di_IHTTPResponse __fastcall Post(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 Post(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 Post(const System::UnicodeString AURL, System::Classes::TStream* 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 */;
_di_IHTTPResponse __fastcall Post(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 einen POST-Befehl an den AURL.

Post ist eine überladene Methode:

  • Mit der ersten überladenen Methode senden Sie eine Rohdatendatei ohne mehrteilige Info an den Remote-URL.
  • Mit der zweiten überladenen Methode senden Sie TStrings-Werte, die eine mehrteilige Info hinzufügen, an den Remote-URL.
  • Mit der dritten überladenen Methode senden Sie einen Stream ohne mehrteilige Info an den Remote-URL.
  • Mit der vierten überladenen Methode senden Sie ein mehrteiliges Formulardatenobjekt an den Remote-URL.

Post gibt eine HTTP-Antwort zurück.

In der folgenden Tabelle finden Sie eine Beschreibung der in den verschiedenen überladenen Methoden verwendeten Parameter:

Parameter Beschreibung
AURL Der URL zum Senden des Befehls.
ASourceFile Ein String mit der Quelldatei zum Bereitstellen der Anforderungsdaten.
ASource
  • In der zweiten überladenen Methode: Das TStrings-Objekt zum Bereitstellen der Daten.
  • In der dritten überladenen Methode: Der Stream zum Bereitstellen der Daten.
  • In der vierten überladenen Methode: Das TMultipartFormData-Objekt zum Bereitstellen der Daten.
AResponseContent Der Stream zum Speichern der Antwortdaten.
AHeaders Weitere Header zur Übergabe mit dem Befehl.
AEncoding Die Verschlüsselung des Parameters ASource in der zweiten überladenen Methode.

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

Siehe auch