System.Net.HttpClientComponent.TNetHTTPRequest.Patch
Delphi
function Patch(const AURL: string; const ASource: TStream = nil; const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IHTTPResponse;
C++
System::Net::Httpclient::_di_IHTTPResponse __fastcall Patch(const System::UnicodeString AURL, System::Classes::TStream* const ASource = (System::Classes::TStream*)(0x0), 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 要求メソッド PATCH を使って指定の URL に指定のデータ（ASource）と共に HTTP 要求を送信し、サーバーが応答を送信するのを待って、サーバーの HTTP 応答を返します。
HTTP クライアントにより応答データ全体がダウンロードされるのを待つのではなく、HTTP クライアント側でターゲット サーバーから応答データをダウンロードしながら応答データを受信する場合は、AResponseContent パラメータを使用して、ダウンロードされたデータを受信するストリームを指定します。あるいは、HTTP クライアントにより応答データ全体がダウンロードされるのを待って、Get から返される応答オブジェクトの ContentStream プロパティから応答データをストリームとして取得することもできます。
データを着信したものから順に受信するか、データ全体が得られるのを待つかに関係なく、OnReceiveData イベントを処理して、応答データのダウンロードの進行状況を追跡することができます。
AHeaders を使用すると、HTTP 要求にカスタム HTTP 要求ヘッダーを含めることができます。
HTTP 要求が HTTP 要求メソッド PATCH をサポートしない可能性があるプロキシ HTTP サーバーを経由する必要がある場合、要求メソッド PUT として要求メソッド PATCH を偽装する代わりに PatchAlternative を使用します。
Patch では、HTTP 要求が要求の HTTP クライアントのリダイレクト数の上限に達すると、ENetHTTPRequestException 例外が発生します。
関連項目
- System.Net.HttpClientComponent.TNetHTTPRequest.Delete
- System.Net.HttpClientComponent.TNetHTTPRequest.Get
- System.Net.HttpClientComponent.TNetHTTPRequest.Head
- System.Net.HttpClientComponent.TNetHTTPRequest.Merge
- System.Net.HttpClientComponent.TNetHTTPRequest.Options
- System.Net.HttpClientComponent.TNetHTTPRequest.Post
- System.Net.HttpClientComponent.TNetHTTPRequest.Put
- System.Net.HttpClientComponent.TNetHTTPRequest.Trace