Cookie を保存し、結果が正しい場合は 0 を返し、それ以外の場合は、その他の値を返します。

構文

SetCookie( Name,  Value [ , Path ] [ , Exp-date ] [ , Domain-name ] [ , Secure ] )

入力値の説明:

Name
Cookie の名前であり、Character タイプです。
Value
格納する値であり、Character タイプです。値はブラウザーに送信される前にエンコードされます。
Path
Cookie が有効になっている Web パネルのパスでであり、Character タイプです。パスを指定しないと、Cookie が格納されているディレクトリーとそのサブディレクトリーにある Web パネルで有効になっていると見なされます。「/」が指定されている場合は、この Cookie はドメイン全体に対して有効です。
Exp-date
Cookie の有効期限です。Date タイプまたは DateTime タイプです。指定されていない場合、ブラウザーのセッションを閉じると期限切れとなります。
Domain-name
Cookie が有効なドメインです。Character タイプです。既定のドメインは、Cookie が作成されたドメインです。
Secure
Numeric タイプです。1 にすると、接続が安全な (HTTPS を使用) 場合のみ、Cookie が送信されます。0 にすると、Cookie が常に送信されます。
戻されるタイプ:
Numeric

適用範囲

オブジェクト:Procedure, Transaction, Web Panel, Data Provider
ジェネレーター: .NET、.NET Framework、Java、Ruby (GeneXus X Evolution 3 まで)

例

次に、Cookie の格納方法の簡単な例をいくつか示します:
例 1

&Op = SetCookie('ID_USER', Str(UsrId), '/', CTOD('01/01/2010') )

ここでは、ID_USER という名前、の Cookie が格納されています。この Cookie はドメイン全体で有効であり、値は UsrId 項目属性に対応します。期限は 2010 年 1 月 1 日です。
例 2

&OK = SetCookie('SESSION_ID_GX', &StrSession, '', Nullvalue(&Date) )

ここでは、SESSION_ID_GX という名前、の Cookie が格納されています。この Cookie は、アプリケーションの Web パネルで有効で、その値は &StrSession という変数に対応します。この Cookie は、ブラウザーを閉じると期限切れとなります。
例 3

&Op = SetCookie('USR_CTRY', 'UY', '/', ADDYR(&Today, 1), 'otherdom.artech.com.uy', 1)

ここでは、USR_CTR という名前の Cookie が格納されています。この Cookie は otherdom ドメインに対して有効であり、その値である UY は今日からちょうど一年後に期限切れとなります。

参考情報

GetCookie 関数