System.Net.HttpClient.THTTPClient.Put

De RAD Studio API Documentation
Aller à : navigation, rechercher

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

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 requête HTTP à l'URL spécifiée avec les données spécifiées (ASource) en utilisant la méthode de requête HTTP PUT, attend une réponse du serveur, et renvoie la réponse HTTP du serveur.

Si vous souhaitez recevoir les données de la réponse au fur et à mesure que votre client HTTP télécharge les données depuis le serveur cible, au lieu d'attendre qu'il télécharge l'intégralité des données, utilisez le paramètre AResponseContent pour spécifier un flux afin de recevoir les données téléchargées. Vous pouvez également attendre que votre client HTTP télécharge l'intégralité des données de la réponse, et obtenir ces données sous la forme d'un flux à partir de la propriété ContentStream de l'objet réponse que Get renvoie.

Quelle que soit la méthode de réception des données (au fur et à mesure du téléchargement ou en attendant la disponibilité de l'intégralité des données), vous pouvez gérer l'événement OnReceiveData pour suivre la progression du téléchargement des données de la réponse.

Utilisez AHeaders pour inclure des en-têtes de requête HTTP personnalisés dans votre requête HTTP.

Put reçoit les paramètres suivants :

  • ASourceFile: string est le chemin local spécifié pour l'envoi du contenu d'un fichier local.
  • ASource: TStrings est une instance TStrings qui une fois fournie envoie le contenu d'une liste de chaînes.
  • ASource: TMultipartFormData est une instance TMultipartFormData qui une fois fournie envoie les données de la fiche sous une forme codée au format message multipart MIME conformément au standard HTML 4.

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

Voir aussi