System.Net.URLClient.TURLClient.BeginExecute

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi 

function BeginExecute(const ARequestMethod: string; const AURI: TURI; const ASourceStream: TStream = nil;
const AContentStream: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginExecute(const AsyncCallbackEvent: TAsyncCallbackEvent; const ARequestMethod: string; const AURI: TURI; const ASourceStream: TStream = nil;
const AContentStream: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginExecute(const AsyncCallback: TAsyncCallback; const ARequestMethod: string; const AURI: TURI; const ASourceStream: TStream = nil;
const AContentStream: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginExecute(const ARequestMethod: string; const AURIStr: string; const ASourceStream: TStream = nil;
const AContentStream: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginExecute(const AsyncCallbackEvent: TAsyncCallbackEvent; const ARequestMethod: string; const AURIStr: string; const ASourceStream: TStream = nil;
const AContentStream: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginExecute(const AsyncCallback: TAsyncCallback; const ARequestMethod: string; const AURIStr: string; const ASourceStream: TStream = nil;
const AContentStream: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;

C++ 

System::Types::_di_IAsyncResult __fastcall BeginExecute(const System::UnicodeString ARequestMethod, const TURI &AURI, System::Classes::TStream* const ASourceStream = (System::Classes::TStream*)(0x0), System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<TNameValuePair> AHeaders = System::DynamicArray<TNameValuePair>())/* overload */;
System::Types::_di_IAsyncResult __fastcall BeginExecute(const System::Classes::TAsyncProcedureEvent AsyncCallbackEvent, const System::UnicodeString ARequestMethod, const TURI &AURI, System::Classes::TStream* const ASourceStream = (System::Classes::TStream*)(0x0), System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<TNameValuePair> AHeaders = System::DynamicArray<TNameValuePair>())/* overload */;
System::Types::_di_IAsyncResult __fastcall BeginExecute(const System::Classes::_di_TAsyncCallback AsyncCallback, const System::UnicodeString ARequestMethod, const TURI &AURI, System::Classes::TStream* const ASourceStream = (System::Classes::TStream*)(0x0), System::Classes::TStream* const AContentStream = (System::Classes::TStream*)(0x0), const System::DynamicArray<TNameValuePair> AHeaders = System::DynamicArray<TNameValuePair>())/* overload */;
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<TNameValuePair> AHeaders = System::DynamicArray<TNameValuePair>())/* overload */;
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<TNameValuePair> AHeaders = System::DynamicArray<TNameValuePair>())/* overload */;
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<TNameValuePair> AHeaders = System::DynamicArray<TNameValuePair>())/* overload */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.Net.URLClient.pas
System.Net.URLClient.hpp
 System.Net.URLClient TURLClient


Description

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=System.Net.URLClient.TURLClient.BeginExecute&oldid=722781 »