|
説明 |
新しい非同期リクエストを作成します。作成したリクエストは、リクエストパラメータなどのプロパティ設定を行った後、PostまたはGetメソッドによりサーバへ送信します。
HttpRequestオブジェクトは１回だけ通信を行うことができます。複数の通信を行う場合、それぞれCreateRequestメソッドにより別々のHttpRequestオブジェクトを作成してください。
HttpAsyncSessionオブジェクトとHttpRequestオブジェクトは密接に関連しています。HttpRequestオブジェクトを作成したときのHttpAsyncSessionオブジェクト以外でGet、Postを行うことはできません。
リクエストパラメータが不要な場合、CreateRequestメソッドは使用せず、GetメソッドにURLを直接記述する形式を利用した方が効率的です。
|
||||||||||
|
呼出形式 |
var req = session.CreateRequest( id, URL [, enc ] )
|
||||||||||
|
戻り値 |
HttpRequestオブジェクトのリファレンスを返します。
|
||||||||||
|
引数 |
String id |
ユニークなセッションIDを指定します。すでに同じIDでリクエストが作成されていたり、通信が行われている場合、例外が発生します。
|
|||||||||
|
|
String URL |
要求するURL。絶対パス、相対パスどちらでも指定可能です。 パスの解釈はCRSの一般的なルールに従います。
|
|||||||||
|
|
integer enc |
POST要求を送信するときの、POSTパラメータのエンコード方法を指定します。 *1 指定できる値は下記のとおりです。省略した場合のデフォルト値はHttpAsyncSession.DEFAULT_ENCODEです。
|
|||||||||
|
例外 |
HTTP-100 |
すでに指定のIDは使用されています |
|||||||||
|
|
HTTP-102 |
IDが無効です |
|||||||||
|
|
HTTP-103 |
セッションを生成できません
|
|||||||||
|
使用例 |
httpAsyncSession session;
var req = session.CreateRequest("Download1", "http://biz-browser.jp/test/prog1.asp");
req.AddParam("code", "0452");
req.AddParam("name", "biz");
session.Post(req);
|
||||||||||
|
関連項目 |
|||||||||||