System.Net.HttpClient.THTTPClient.Post

De RAD Studio API Documentation
Aller à : navigation, rechercher

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 */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.Net.HttpClient.pas
System.Net.HTTPClient.hpp
System.Net.HttpClient THTTPClient


Description

Envoie une commande POST à l'AURL.

Post est une méthode surchargée :

  • Appelez la première méthode surchargée pour expédier un fichier brut sans informations multiparties à l'URL distante.
  • Appelez la deuxième méthode surchargée pour expédier des valeurs Tstrings en ajoutant des informations multiparties à l'URL distante.
  • Appelez la troisième méthode surchargée pour expédier un flux sans informations multiparties à l'URL distante.
  • Appelez la quatrième méthode surchargée pour expédier un objet données de fiche multipartie à l'URL distante.

Post renvoie une réponse HTTP.

Vous trouverez dans le tableau ci-dessous une description des paramètres utilisés dans les différentes méthodes surchargées :

Paramètre Description
AURL L'URL permettant d'envoyer la commande.
ASourceFile Une chaîne avec le fichier source permettant de fournir les données de requête.
ASource
  • Dans la deuxième méthode surchargée : le TStrings permettant de fournir les données.
  • Dans la troisième méthode surchargée : le flux permettant de fournir les données.
  • Dans la quatrième méthode surchargée : le TMultipartFormData permettant de fournir les données.
AResponseContent Le flux permettant de stocker le contenu de réponse.
AHeaders En-têtes supplémentaires à transmettre avec la commande.
AEncoding Le codage du paramètre ASource dans la deuxième méthode surchargée.

Post déclenche une exception ENetHTTPRequestException si la requête HTTP atteint le nombre maximal de redirections.

Voir aussi