HttpSession.AddCookieメソッド

説明

クライアント側からのクッキーを追加します。

CreateRequestメソッド、Getメソッド等で指定するURLとAddCookieメソッドで指定するpathが一致する場合のみ、クッキーをリクエストヘッダに追加します。

pathを省略した場合、URLに関わらずクッキーを追加します。

nameとvalueが既に追加済みのクッキーと一致する場合、追加済みのvalueを更新します。

呼出形式

session.AddCookie( name, value [, path])

戻り値

なし

引数

String name

クッキーの名前

String value

クッキーの値

String path

クッキーの追加対象となるURL

省略した場合、CreateRequestメソッド、Getメソッド等で指定するURLに関わらずクッキーを追加します。

例外

HTTP-11

不正なヘッダ情報です

使用例

var session = HttpSession.GetSession();
session.AddCookie("name1", "value1", "/sample.txt");
session.AddCookie("name2", "value2", "/sample2.txt");
session.AddCookie("name3", "value3");
/* Getメソッドで指定するURLとAddCookieメソッドで指定したpathが一致するname1, value1と */
/* AddCookieメソッドでpathを省略したname3, value3がクッキーとして追加される */
var res = session.Get("/sample.txt");
print(res.body);

関連項目

RemoveCookieメソッド