API:System.Net.HttpClient.THTTPClient.BeginExecute

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi 

function BeginExecute(const ARequest: IHTTPRequest; const AContentStream: TStream = nil;
const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginExecute(const AsyncCallback: TAsyncCallback; const ARequest: IHTTPRequest;
const AContentStream: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginExecute(const AsyncCallbackEvent: TAsyncCallbackEvent; const ARequest: IHTTPRequest;
const AContentStream: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;

C++ 

HIDESBASE System::Types::_di_IAsyncResult __fastcall BeginExecute(const _di_IHTTPRequest ARequest, System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>())/* overload */;
HIDESBASE System::Types::_di_IAsyncResult __fastcall BeginExecute(const System::Classes::_di_TAsyncCallback AsyncCallback, const _di_IHTTPRequest ARequest, System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>())/* overload */;
HIDESBASE System::Types::_di_IAsyncResult __fastcall BeginExecute(const System::Classes::TAsyncProcedureEvent AsyncCallbackEvent, const _di_IHTTPRequest ARequest, System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>())/* overload */;
inline System::Types::_di_IAsyncResult __fastcall  BeginExecute(const System::UnicodeString ARequestMethod, const System::Net::Urlclient::TURI &AURI, System::Classes::TStream* const ASourceStream = (System::Classes::TStream*)(0x0), System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>()){ return System::Net::Urlclient::TURLClient::BeginExecute(ARequestMethod, AURI, ASourceStream, AContentStream, AHeaders); }
inline System::Types::_di_IAsyncResult __fastcall  BeginExecute(const System::Classes::TAsyncProcedureEvent AsyncCallbackEvent, const System::UnicodeString ARequestMethod, const System::Net::Urlclient::TURI &AURI, System::Classes::TStream* const ASourceStream = (System::Classes::TStream*)(0x0), System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>()){ return System::Net::Urlclient::TURLClient::BeginExecute(AsyncCallbackEvent, ARequestMethod, AURI, ASourceStream, AContentStream, AHeaders); }
inline System::Types::_di_IAsyncResult __fastcall  BeginExecute(const System::Classes::_di_TAsyncCallback AsyncCallback, const System::UnicodeString ARequestMethod, const System::Net::Urlclient::TURI &AURI, System::Classes::TStream* const ASourceStream = (System::Classes::TStream*)(0x0), System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>()){ return System::Net::Urlclient::TURLClient::BeginExecute(AsyncCallback, ARequestMethod, AURI, ASourceStream, AContentStream, AHeaders); }
inline System::Types::_di_IAsyncResult __fastcall  BeginExecute(const System::UnicodeString ARequestMethod, const System::UnicodeString AURIStr, System::Classes::TStream* const ASourceStream = (System::Classes::TStream*)(0x0), System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>()){ return System::Net::Urlclient::TURLClient::BeginExecute(ARequestMethod, AURIStr, ASourceStream, AContentStream, AHeaders); }
inline System::Types::_di_IAsyncResult __fastcall  BeginExecute(const System::Classes::TAsyncProcedureEvent AsyncCallbackEvent, const System::UnicodeString ARequestMethod, const System::UnicodeString AURIStr, System::Classes::TStream* const ASourceStream = (System::Classes::TStream*)(0x0), System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>()){ return System::Net::Urlclient::TURLClient::BeginExecute(AsyncCallbackEvent, ARequestMethod, AURIStr, ASourceStream, AContentStream, AHeaders); }
inline System::Types::_di_IAsyncResult __fastcall  BeginExecute(const System::Classes::_di_TAsyncCallback AsyncCallback, const System::UnicodeString ARequestMethod, const System::UnicodeString AURIStr, System::Classes::TStream* const ASourceStream = (System::Classes::TStream*)(0x0), System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>()){ return System::Net::Urlclient::TURLClient::BeginExecute(AsyncCallback, ARequestMethod, AURIStr, ASourceStream, AContentStream, AHeaders); }

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 URL asynchrone.

System.Net.HttpClient.THTTPClient.BeginExecute hérite de System.Net.URLClient.TURLClient.BeginExecute. Tout le contenu en-dessous de cette ligne se réfère à System.Net.URLClient.TURLClient.BeginExecute.

Démarre une requête URL asynchrone.

Lorsque vous appelez BeginExecute, vous devez fournir les données nécessaires à l'exécution de votre requête URL :

  • ARequestMethod est une chaîne qui définit la méthode de requête à utiliser. Les méthodes de requête possibles dépendent du protocole.
  • AURI (TURI) ou AURIStr (chaîne) est un URI qui identifie l'emplacement de la ressource que vous demandez.
  • ASourceStream (facultatif) est un flux de données à fournir dans la requête.
  • AContentStream (facultatif) est un flux permettant de contenir les données incluses dans la réponse.
  • AHeaders (facultatif) est une liste d'en-têtes à inclure dans la requête.
  • AsyncCallback (facultatif) est une procédure de rappel à 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, si AsyncCallback vaut nil.

BeginExecute renvoie un objet de réponse qui commence par être rempli avec les données de la réponse de façon asynchrone.

Quand toutes les données de la réponse sont reçues dans l'objet de réponse, la fonction de rappel ou le gestionnaire d'événement sont appelés et fournissent l'objet de réponse correspondant comme paramètre.

Appelez EndAsyncURL avec l'objet de réponse cible en tant que paramètre afin d'assurer que l'opération s'est déroulée avec succès ; EndAsyncURL déclenche une exception s'il s'est produit un problème au cours de la requête, comme un délai d'expiration.

D'ordinaire, vous pouvez appeler EndAsyncURL à l'intérieur de la fonction de rappel ou du gestionnaire d'événement, là où l'on sait que les données de la réponse ont déjà été reçues. Cependant, vous pouvez appeler EndAsyncURL à n'importe quel moment, ce qui arrête l'exécution du programme jusqu'à réception des données de la réponse, transformant en réalité la requête asynchrone en requête synchrone.

Voir aussi

Récupérée de « https://docwiki.embarcadero.com/Libraries/Alexandria/f/index.php?title=API:System.Net.HttpClient.THTTPClient.BeginExecute&oldid=804620 »