System.Net.HttpClientComponent.TNetHTTPRequest.Options

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

Delphi 

function Options(const AURL: string; const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IHTTPResponse;

C++ 

System::Net::Httpclient::_di_IHTTPResponse __fastcall Options(const System::UnicodeString AURL, System::Classes::TStream* const AResponseContent = (System::Classes::TStream*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>());

プロパティ

種類 可視性 ソース ユニット 親
function public
System.Net.HTTPClientComponent.pas
System.Net.HTTPClientComponent.hpp
 System.Net.HttpClientComponent TNetHTTPRequest


説明

HTTP 要求メソッド OPTIONS を使って指定の URL に HTTP 要求を送信し、サーバーが応答を送信するのを待って、サーバーの HTTP 応答を返します。

HTTP クライアントにより応答データ全体がダウンロードされるのを待つのではなく、HTTP クライアント側でターゲット サーバーから応答データをダウンロードしながら応答データを受信する場合は、AResponseContent パラメータを使用して、ダウンロードされたデータを受信するストリームを指定します。あるいは、HTTP クライアントで応答データ全体がダウンロードされるのを待って、Options から返される応答オブジェクトの ContentStream プロパティから応答データをストリームとして取得することもできます。

データを着信したものから順に受信するか、データ全体が得られるのを待つかに関係なく、OnReceiveData イベントを処理して、応答データのダウンロードの進行状況を追跡することができます。

AHeaders を使用すると、HTTP 要求にカスタム HTTP 要求ヘッダーを含めることができます。

Options では、HTTP 要求が要求の HTTP クライアントのリダイレクト数の上限に達すると、ENetHTTPRequestException 例外が発生します。

関連項目

「http://docwiki.embarcadero.com/Libraries/Sydney/j/index.php?title=System.Net.HttpClientComponent.TNetHTTPRequest.Options&oldid=690826」から取得