System.Net.HttpClient.THTTPClient.BeginGetRange

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Net.HttpClient.pas
System.Net.HTTPClient.hpp
System.Net.HttpClient THTTPClient


Beschreibung

Beginnt eine asynchrone HTTP-Anforderung mit der GET-HTTP-Anforderungsmethode mit dem Range-Header.

Der Range-Header gibt ein bestimmtes Fragment der Quelldaten, die Sie empfangen möchten, an.

Wenn Sie BeginGetRange aufrufen, müssen Sie die Daten, die zur Ausführung der HTTP-Anforderung erforderlich sind, bereitstellen:

  • AURL ist eine Ziel-URL Ihrer Anforderung.
  • AStart ist das Start-Byte des Bereichs der Quelldaten, die Sie anfordern.
  • AEnd ist das End-Byte des Bereichs der Quelldaten, die Sie anfordern. Verwenden Sie -1 (standard), um die Daten von AStart bis zum Ende anzufordern.
  • AResponseContent (optional) ist ein Stream, in dem Sie die Antwortdaten erhalten möchten, wenn Ihr HTTP-Client die Antwortdaten vom Zielserver herunterlädt.

Wenn Sie keinen Stream für AResponseContent angeben, können Sie auch warten, bis Ihr HTTP-Client die gesamten Antwortdaten heruntergeladen hat, und die Antwortdaten als Stream aus der Eigenschaft ContentStream des asynchronen Ergebnisobjekts abrufen, das BeginGetRange zurückgibt.
  • AHeaders (optional) ist eine Liste der Header, die der Anforderung hinzugefügt werden müssen.
  • AsyncCallback (optional) ist eine Callback-Prozedur, die aufgerufen werden muss, wenn eine Antwort empfangen wird oder die Anforderung fehlschlägt.
  • AsyncCallbackEvent (optional) ist eine Ereignisbehandlungsroutine, die aufgerufen werden muss, wenn eine Antwort empfangen wird oder eine Anforderung fehlschlägt.

Weitere Informationen finden Sie unter BeginExecute.

Siehe auch