HttpAsyncSession.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

不正なヘッダ情報です

使用例

HttpAsyncSession session {
    Function OnSessionEnd(e) {
        if (e.id == "Download1") {
            if (e.status != $HTTP_OK) {
                //.MessageBox("通信エラー:" + str(e.status), "ERROR", $OK);
            }
        }
    }
}
Button btnAddCookie {
    Function OnTouch(e) {
        ^.session.AddCookie("name1", "value1", "/sample.txt");
        ^.session.AddCookie("name2", "value2", "/sample2.txt");
        ^.session.AddCookie("name3", "value3");
    }
}
Button btnDownload {
    Function OnTouch(e) {
        /* Getメソッドで指定するURLとAddCookieメソッドで指定したpathが一致するname1, value1と */
        /* AddCookieメソッドでpathを省略したname3, value3がクッキーとして追加される */
        ^.session.Get("Download1", "/sample1");
    }
}

関連項目

RemoveCookieメソッド