HttpAsyncSession.CreateRequestメソッド

説明

新しい非同期リクエストを作成します。作成したリクエストは、リクエストパラメータなどのプロパティ設定を行った後、PostまたはGetメソッドによりサーバへ送信します。

HttpRequestオブジェクトは１回だけ通信を行うことができます。複数の通信を行う場合、それぞれCreateRequestメソッドにより別々のHttpRequestオブジェクトを作成してください。

HttpAsyncSessionオブジェクトとHttpRequestオブジェクトは密接に関連しています。HttpRequestオブジェクトを作成したときのHttpAsyncSessionオブジェクト以外でGet、Postを行うことはできません。

リクエストパラメータが不要な場合、CreateRequestメソッドは使用せず、GetメソッドにURLを直接記述する形式を利用した方が効率的です。

呼出形式

var req = session.CreateRequest( id, URL )

戻り値

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

引数

String id

ユニークなセッションIDを指定します。すでに同じIDでリクエストが作成されていたり、通信が行われている場合、例外が発生します。

String URL

要求するURL。絶対パス、相対パスどちらでも指定可能です。

パスの解釈はCRSの一般的なルールに従います。

例外

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);

関連項目

Get、Postメソッド

HttpRequest、HttpResponseクラス