System.Net.HttpClientComponent.TNetHTTPClient.Trace

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

Delphi

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

C++

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

プロパティ

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


説明

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

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

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

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

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

関連項目