System.Net.HttpClient.THTTPClient.BeginPost

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function BeginPost(const AURL: string; const ASourceFile: string; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AsyncCallback: TAsyncCallback; const AURL: string; const ASourceFile: string; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AsyncCallbackEvent: TAsyncCallbackEvent; const AURL: string; const ASourceFile: string; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AURL: string; const ASource: TStrings; const AResponseContent: TStream = nil;
const AEncoding: TEncoding = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AsyncCallback: TAsyncCallback; const AURL: string; const ASource: TStrings;
const AResponseContent: TStream = nil; const AEncoding: TEncoding = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AsyncCallbackEvent: TAsyncCallbackEvent; const AURL: string; const ASource: TStrings;
const AResponseContent: TStream = nil; const AEncoding: TEncoding = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AURL: string; const ASource: TStream; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AsyncCallback: TAsyncCallback; const AURL: string; const ASource: TStream;
const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AsyncCallbackEvent: TAsyncCallbackEvent; const AURL: string; const ASource: TStream;
const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AURL: string; const ASource: TMultipartFormData; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AsyncCallback: TAsyncCallback; const AURL: string; const ASource: TMultipartFormData;
const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginPost(const AsyncCallbackEvent: TAsyncCallbackEvent; const AURL: string; const ASource: TMultipartFormData;
const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;

C++

System::Types::_di_IAsyncResult __fastcall BeginPost(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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(const System::Classes::_di_TAsyncCallback AsyncCallback, 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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(const System::Classes::TAsyncProcedureEvent AsyncCallbackEvent, 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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(const System::Classes::_di_TAsyncCallback AsyncCallback, 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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(const System::Classes::TAsyncProcedureEvent AsyncCallbackEvent, 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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(const System::Classes::_di_TAsyncCallback AsyncCallback, 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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(const System::Classes::TAsyncProcedureEvent AsyncCallbackEvent, 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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(const System::Classes::_di_TAsyncCallback AsyncCallback, 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 */;
System::Types::_di_IAsyncResult __fastcall BeginPost(const System::Classes::TAsyncProcedureEvent AsyncCallbackEvent, 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

Démarre une requête HTTP asynchrone en utilisant la méthode de requête HTTP POST.

Pour spécifier les données à envoyer quand vous appelez BeginPost, effectuez l'une des actions suivantes :

  • Pour envoyer le contenu d'un fichier local, spécifiez le chemin local de ce fichier dans ASourceFile.
  • Pour envoyer le contenu d'une liste de chaînes, fournissez votre instance de TStrings en tant que ASource, et si vos chaînes ne sont pas encodées en UTF-8, fournissez une instance de TEncoding en tant que AEncoding.
  • Pour envoyer le contenu d'un flux, fournissez votre instance de TStream en tant que ASource.
  • Pour envoyer les données de fiche encodées en tant que message multi-partie MIME suivant le standard HTML 4, fournissez votre instance de TMultipartFormData en tant que ASource.

BeginPost reçoit également les paramètres suivants :

  • AURL est l'URL cible de votre requête.
  • AResponseContent (facultatif) est un flux où vous souhaitez recevoir les données de réponse au fur et à mesure que votre client HTTP télécharge les données de réponse depuis le serveur cible.

Si vous ne spécifiez pas un flux pour AResponseContent, vous pouvez attendre que votre client HTTP télécharge les données de la réponse entière, et obtenir les données de la réponse sous la forme d'un flux à partir de la propriété ContentStream de l'objet de résultat asynchrone que BeginPost renvoie.
  • AHeaders (facultatif) est une liste d'en-têtes à inclure dans la requête.
  • AsyncCallback (facultatif) est une procédure callback à appeler lorsqu'une réponse est reçue ou que la requête échoue.
  • AsyncCallbackEvent (facultatif) est un gestionnaire d'événement à appeler lorsqu'une réponse est reçue ou que la requête échoue.

Pour plus d'informations, voir BeginExecute.

Voir aussi