HttpSession.Postメソッド

説明

接続先のサーバへPOSTリクエストを送信し、結果をHttpResponseオブジェクトのリファレンスで受け取ります。

リクエストに含めるリクエストパラメータは、HttpRequest.AddParamメソッドで設定します。

HTTPレイヤーの実行結果は、戻り値で返されるHttpResponseオブジェクトのStatusプロパティで確認します。

呼出形式

var res = session.Post( req )

戻り値

HttpResponseオブジェクトのリファレンスを返します。

引数

HttpRequest req

要求リクエストを示す、HttpRequestオブジェクト。CreateRequestメソッドで作成します。

例外

HTTP-2

指定のhttpRequestはコネクション先が異なります

HTTP-3

リクエストを送信できません

HTTP-4

GETまたはPOSTに指定のリクエストオブジェクトは不正です

HTTP-5

指定のリクエストURLはコネクション先と異なります

HTTP-6

リクエストがエラー終了しました

使用例

var session = findHTTPSession("http://biz-browser.jp");
var req = session.CreateRequest("/test/prog1");
req.AddParam("code", "0452");
req.AddParam("name", "Biz");
var res = session.Post(req);
if (res.Status != $HTTP_OK) {
    MessageBox("通信エラー:" + str(res.Status), "ERROR", $OK);
    return;
}

関連項目

CreateRequestメソッド

HttpRequest、HttpResponseクラス