System.Net.HttpClientComponent.TNetHTTPClient.Put
Delphi
function Put(const AURL: string; const ASourceFile: string; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;
function Put(const AURL: string; const ASource: TStrings; const AResponseContent: TStream = nil;
const AEncoding: TEncoding = nil; const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;
function Put(const AURL: string; const ASource: TStream = nil; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;
function Put(const AURL: string; const ASource: TMultipartFormData; const AResponseContent: TStream = nil;
const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;
C++
System::Net::Httpclient::_di_IHTTPResponse __fastcall Put(const System::UnicodeString AURL, const System::UnicodeString ASourceFile, 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::Net::Httpclient::_di_IHTTPResponse __fastcall Put(const System::UnicodeString AURL, System::Classes::TStrings* const ASource, System::Classes::TStream* const AResponseContent = (System::Classes::TStream*)(0x0), System::Sysutils::TEncoding* const AEncoding = (System::Sysutils::TEncoding*)(0x0), const System::DynamicArray<System::Net::Urlclient::TNameValuePair> AHeaders = System::DynamicArray<System::Net::Urlclient::TNameValuePair>())/* overload */;
System::Net::Httpclient::_di_IHTTPResponse __fastcall Put(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>())/* overload */;
System::Net::Httpclient::_di_IHTTPResponse __fastcall Put(const System::UnicodeString AURL, System::Net::Mime::TMultipartFormData* const ASource, 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.HTTPClientComponent.pas System.Net.HTTPClientComponent.hpp |
System.Net.HttpClientComponent | TNetHTTPClient |
説明
HTTP リクエストを、PUT
HTTP リクエスト メソッドを使用して、指定されたデータ(ASource
)を持つ指定の URL に送信し、サーバーがレスポンスを送信するのを待って、サーバーの HTTP レスポンスを返します。
HTTP クライアントにより応答データ全体がダウンロードされるのを待つのではなく、HTTP クライアント側でターゲット サーバーから応答データをダウンロードしながら応答データを受信する場合は、AResponseContent
パラメータを使用して、ダウンロードされたデータを受け取るストリームを指定します。 あるいは、HTTP クライアントにより応答データ全体がダウンロードされるのを待って、Get が返す応答オブジェクトの ContentStream プロパティを取得することもできます。
データを着信したものから順に受信するか、データ全体が得られるのを待つかに関係なく、OnReceiveData イベントを処理して、応答データのダウンロードの進行状況を追跡することができます。
AHeaders
を使用すると、カスタム HTTP 要求ヘッダーを HTTP 要求に含めることができます。
Put はまた、次のパラメータを受け取ります:
ASourceFile: string
は、ローカル ファイルのコンテンツを送信するローカル パスを示します。ASource: TStrings
は TStrings インスタンスであり、一度提供されると、文字列リストのコンテンツを送信します。ASource: TMultipartFormData
は TMultipartFormData インスタンスであり、一度提供されると、HTML 4 標準にしたがってMIME マルチパート メッセージでエンコードされたフォーム データを送信します。
Put は、HTTP リクエストがリダイレクトの最大数に到達した場合、ENetHTTPRequestException を発生させます。
関連項目
- System.Net.HttpClientComponent.TNetHTTPClient.Delete
- System.Net.HttpClientComponent.TNetHTTPClient.Get
- System.Net.HttpClientComponent.TNetHTTPClient.Head
- System.Net.HttpClientComponent.TNetHTTPClient.Merge
- System.Net.HttpClientComponent.TNetHTTPClient.Options
- System.Net.HttpClientComponent.TNetHTTPClient.Patch
- System.Net.HttpClientComponent.TNetHTTPClient.Post
- System.Net.HttpClientComponent.TNetHTTPClient.Trace