System.Net.HttpClient.THTTPClient.BeginGetRange

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function BeginGetRange(const AURL: string; AStart: Int64; AnEnd: Int64 = -1; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginGetRange(const AsyncCallback: TAsyncCallback; const AURL: string; AStart: Int64; AnEnd: Int64 = -1;
const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;
function BeginGetRange(const AsyncCallbackEvent: TAsyncCallbackEvent; const AURL: string; AStart: Int64; AnEnd: Int64 = -1;
const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IAsyncResult; overload;

C++

System::Types::_di_IAsyncResult __fastcall BeginGetRange(const System::UnicodeString AURL, __int64 AStart, __int64 AnEnd = -1LL, 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 BeginGetRange(const System::Classes::_di_TAsyncCallback AsyncCallback, const System::UnicodeString AURL, __int64 AStart, __int64 AnEnd = -1LL, 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 BeginGetRange(const System::Classes::TAsyncProcedureEvent AsyncCallbackEvent, const System::UnicodeString AURL, __int64 AStart, __int64 AnEnd = -1LL, 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 GET avec l'en-tête Range.

L'en-tête Range indique un fragment spécifique des données source que vous voulez recevoir.

Lorsque vous appelez BeginGetRange, vous devez fournir les données requises pour effectuer votre requête HTTP :

  • AURL est l'URL cible de votre requête.
  • AStart est l'octet de début de l'intervalle de données source que vous demandez.
  • AEnd est l'octet de fin de l'intervalle de données source que vous demandez. Utilisez -1 (valeur par défaut) pour demander les données à partir de AStart jusqu'à la fin.
  • 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 BeginGetRange 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