System.Net.HttpClient.THTTPClient.BeginGetRange

提供: RAD Studio API Documentation
移動先: 案内検索

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

プロパティ

種類 可視性 ソース ユニット
function public
System.Net.HttpClient.pas
System.Net.HTTPClient.hpp
System.Net.HttpClient THTTPClient


説明

非同期 HTTP リクエストを、GET HTTP リクエスト メソッドを Range ヘッダーと共に使用して開始します。

Range ヘッダーは、受信したいソース データの特定の部分を示します。

BeginGetRange を呼び出す際、HTTP リクエストを実行するのに必要なデータを提供しなければなりません:

  • AURL は、リクエストのターゲット URL です。
  • AStart は、リクエストするソース データの範囲の開始バイトです。
  • AEnd は、リクエストするソース データの範囲の終了バイトです。 -1(デフォルト)を使用すると、AStart から終了までのデータを要求します。
  • AResponseContent(省略可能)は、HTTP クライアントがターゲット サーバーからレスポンス データをダウンロードする際、レスポンス データを取得したいストリームです。

AResponseContent に対してストリームを指定しない場合、HTTP クライアントがレスポンス データをすべてダウンロードするのを待って、BeginGetRange から返される非同期結果オブジェクトContentStream プロパティから、ストリームとしてレスポンス データを取得することもできます。

  • AHeaders(省略可能)は、リクエストに含まれるヘッダーのリストです。
  • AsyncCallback(省略可能)は、レスポンスが受け取られたとき、またはリクエストが失敗した際に呼び出されるコールバック プロシージャです。
  • AsyncCallbackEvent(省略可能)は、レスポンスが受け取られたとき、またはリクエストが失敗した際に呼び出されるイベント ハンドラです。

isc_portable_integer() の詳細については、BeginExecuteを参照してください。

関連項目