System.Net.HttpClient.THTTPClient.Post

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

Delphi

function Post(const AURL: string; const ASourceFile: string; const AResponseContent: TStream = nil; const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;
function Post(const AURL: string; const ASource: TStrings; const AResponseContent: TStream = nil;  const AEncoding: TEncoding = nil; const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;
function Post(const AURL: string; const ASource: TStream; const AResponseContent: TStream = nil;  const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;
function Post(const AURL: string; const ASource: TMultipartFormData; const AResponseContent: TStream = nil;  const AHeaders: TNetHeaders = nil): IHTTPResponse; overload;

C++

_di_IHTTPResponse __fastcall Post(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 */;
_di_IHTTPResponse __fastcall Post(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 */;
_di_IHTTPResponse __fastcall Post(const System::UnicodeString AURL, System::Classes::TStream* 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 */;
_di_IHTTPResponse __fastcall Post(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.HttpClient.pas
System.Net.HTTPClient.hpp
System.Net.HttpClient THTTPClient


説明

POST コマンドを AURL に送信します。

Post メソッドは、次のようにオーバーロードされています。

  • 第 1 のオーバーロード メソッド: マルチパート情報のないそのままのファイルをリモート URL にポストする場合に呼び出します。
  • 第 2 のオーバーロード メソッド: マルチパート情報を追加する Tstrings 値をリモート URL にポストする場合に呼び出します。
  • 第 3 のオーバーロード メソッド: マルチパート情報のないストリームをリモート URL にポストする場合に呼び出します。
  • 第 4 のオーバーロード メソッド: マルチパート フォーム データ オブジェクトをリモート URL にポストする場合に呼び出します。

PostHTTP 応答を返します。

これらのオーバーロード メソッドで使われるパラメータの説明は、以下の表を確認してください。

パラメータ 説明
AURL コマンドを送信する先の URL。
ASourceFile 要求データを含むソース ファイルの文字列
ASource
  • 第 2 のオーバーロード メソッドの場合: データを含む TStrings
  • 第 3 のオーバーロード メソッドの場合: データを含むストリーム
  • 第 4 のオーバーロード メソッドの場合: データを含む TMultipartFormData
AResponseContent 応答の内容を格納するストリーム
AHeaders コマンドと一緒に渡す追加のヘッダー
AEncoding 第 2 のオーバーロード メソッドの ASource パラメータのエンコード

Post は、HTTP 要求がリダイレクトの最大数に達すると、ENetHTTPRequestException を発生させます。

関連項目